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Avant-propos 


1. Pourquoi ce livre ? 


Qui n'a jamais rêvé de faire fortune en créant le prochain Angry Birds ou Can- 
dy Crush ? Mais bien sûr, les temps ont changé et il est désormais impératif 
d'avoir son application sur le plus de plateformes possible pour toucher un 
maximum de personnes. C'est cette volonté qui nous a, Maxime et moi, lancés 
sur le chemin d'Unity : un seul développement sur une plateforme dédiée à la 
2D et à la 3D pouvant être déployé sur plus d'une vingtaine de plateformes. 


Depuis 2012 et au fur et à mesure de nos développements avec Unity, nous 
nous sommes rendu compte d'un mensonge : Unity n'est en fait pas unique- 
ment dédié au développement de jeux, il peut tout à fait être utilisé dans des 
applications d'entreprise. Modélisation d'objets 3D, création d'environne- 
ments immersifs, applications de présentation de produits : la liste des pos- 
sibles est longue. 


En partageant notre passion autour de nous, nous avons réalisé qu'il y avait 
très peu de ressources disponibles en français pour débuter le développement 
avec Unity. Nous avons donc eu la volonté d'écrire ce livre afin de concrétiser 
notre volonté de partager notre passion d'Unity. 


Au moment de commencer l'écriture de ce livre, Unity venait de sortir une 
version très mature, stable et éprouvée : la 5. 


SO (fifiy D 
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2. À qui s'adresse cet ouvrage ? 


Ce livre s'adresse tout d'abord aux professionnels désireux de comprendre et 
de mettre en œuvre le développement d'applications en deux dimensions (2D) 
ou en trois dimensions (3D) à l'aide d'Unity. Cet ouvrage s'adresse aussi aux 
développeurs considérant, à juste titre, Unity comme une excellente solution 
de développement d'applications multiplateformes. 


Il est écrit pour des développeurs ayant une première connaissance en .NET, 
notamment C# ou C++. 


Cet ouvrage pourra autant trouver sa place dans la bibliothèque d'une entre- 
prise développant des applications d'entreprise que dans celle d'un déve- 
loppeur passionné souhaitant développer des jeux vidéo sur son temps libre. 


3. Structure de l'ouvrage 


Ce livre peut être parcouru dans son intégralité et utilisé comme support de 
formation. Il peut également être consulté par lecture de chapitres indépen- 
dants. 


Dans un premier temps, une présentation du contexte du développement 
d'applications 2D/3D et plus particulièrement avec Unity sera réalisée. L'édi- 
teur Unity et son interface seront notamment présentés in extenso. 


Sont ensuite présentés en profondeur les objets manipulés par Unity afin de 
permettre la mise en place de code intelligent. Le système de scripting permet- 
tant cela est alors expliqué ainsi que les différentes possibilités dans ce 
domaine. Un chapitre est dédié à la présentation des différentes interactions 
possibles entre l'application et l'utilisateur en fonction des plateformes 
d'exécution. 


Il est ensuite expliqué les différents mécanismes d'affichages avancés et de pré- 
sentation de données à l'utilisateur : images, vidéos, système audio, différentes 
possibilités d'import d'assets graphiques ainsi que le système d'animation très 
puissant d'Unity. 


La mise en place d'une simulation de la gravité et des lois de la physique dans 
un environnement 2D ou 3D est décrite dans un chapitre dédié. 
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Est ensuite présenté le nouveau système d'Unity permettant la création 
d'interfaces graphiques de façon efficace, extensible et intégrée dans une scène 
à plusieurs dimensions. 


Un chapitre présente alors les possibilités d'interfaçage avec des services héber- 
gés sur Internet et les possibilités apportées par le système UNET apparu dans 
la sous-version 5.1 d'Unity 5 pour la création de scénarios multijoueurs. 


Finalement, le dernier chapitre présente les différentes possibilités et person- 
nalisations possibles lors de la création de l'exécutable final, plateforme par 
plateforme. 
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| Chapitre 1 
Unity et le développement 
de jeux vidéo 


1. Qu'est-ce que Unity ? 


1.1 Introduction 


Unity est un moteur de jeu développé par la société Unity Technologies. À son 
lancement en juin 2005, Unity 1.0 ne prenait en charge que Mac OS X. Un peu 
plus de dix ans plus tard, Unity 5 permet de créer des jeux ou des applications 
sur pas moins d'une vingtaine de plateformes différentes. Son adoption auprès 
des acteurs de l'industrie vidéo ludique a été très forte grâce à la facilité et à la 
rapidité de création des prototypes. Du côté des indépendants, un très fort 
pourcentage utilise Unity pour sa facilité de prise en main et la facilité de pro- 
duire des jeux sur un maximum de plateformes possibles sans avoir à redéve- 
lopper entièrement son jeu. 
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1.2 Les plateformes supportées 


Unity peut se vanter d'avoir l'une des offres les plus conséquentes en termes 
de plateformes supportées. 


— Pour le bureau : 
— Windows 
— Windows Store Apps 
— Mac 
— Linux/Steam OS 
— Pour les mobiles : 
— i0S 
— Android 
— Windows Phone 
— Tizen 
— Pour les consoles : 
— PlayStation 3 
— PlayStation 4 
— PlayStation Vita 
— Xbox 360 
— Xbox One 
- Wii U 
— Pour le Web : 
— Web Player 
— WebGL 
— Pour la réalité augmentée : 
— Oculus Rift 
— Gear VR 
— Microsoft Hololens 
— Project Morpheus 
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1.3 


1.3.1 


1.3.2 


1.4 


Chapitre 1 


Les licences 


Unity propose deux types de licences : une version gratuite (Personal Edition) 
et une version payante (Professional Edition). 


Personal Edition 


Dans sa version gratuite, Unity propose l'accès à toutes les fonctionnalités du 
moteur ainsi que le déploiement sur toutes les plateformes disponibles. La 
contrepartie étant qu'au lancement de votre application, un écran de démar- 
rage apparaît avec le logo d'Unity. 


Professional Edition 


Bien évidemment, la version payante est, quant à elle, beaucoup plus fournie 
avec un accès gratuit (temporaire dans certains cas) aux différents services 
tiers proposés par la firme comme Unity Analytics Pro, Unity Cloud Build Pro 
ou encore un accès à l'Asset Store Level 11. Cette fois-ci, l'écran de Seramee 
est entièrement paramétrable. 


À noter que les entreprises ayant réalisé un chiffre d’affaires supérieur de 
100 000 $ pour l'année doivent obligatoirement acheter les add-ons pour iOS 
et Android s'ils veulent utiliser ces plateformes. 


La technologie 


Le moteur de jeu est développé en très grande partie en C++ avec quelques 
rares morceaux de code en C. Pour Unity, le développeur ne doit pas avoir à 
faire de modification dans le moteur ; d'ailleurs, celui-ci n'est pas accessible et 
le code source n'est pas fourni. Par le biais d'un éditeur ultra complet, flexible 
et personnalisable, les développeurs mettent en place le projet directement en 
y ajoutant du contenu 2D ou 3D ainsi qu'en créant des scripts personnalisés. 


Ces scripts peuvent être écrits en trois langages différents : C#, UnityScript 
(se rapprochant fortement du JavaScript) et Boo, ce dernier étant peu à peu 
laissé à l'abandon. Le moteur de scripting s'appuie sur l'implémentation open 
source du framework .NET : Mono. Ceci ne permet pas de jouir de l'intégralité 
des nouveautés du framework car la version de Mono utilisée dans Unity cor- 
respond, à peu de choses près, à la version du framework .NET 2.0. 
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Pour quels projets Unity est-il adapté ? 


Unity permet de créer n'importe quel type de jeu vidéo, que ce soit un FPS 
(First Person Shooter), une simulation de course automobile ou un jeu de plate- 
forme en 2D. 


Depuis quelques années, Unity propose de différencier les projets d'applica- 
tion 2D et 3D. L'éditeur offre donc des vues et des actions propres à chacun 
des types de jeu et le moteur a été modifié, notamment pour tout ce qui 
touche au moteur physique (collisions entre les différents objets, ajout de 
force, pesanteur.…), pour permettre de meilleures performances. 


. Pourquoi utiliser Unity ? 


Unity s'est fait une place de choix dans le cœur des développeurs grâce à sa ra- 
pidité de prise en main. Si l'on regarde du côté de la concurrence, beaucoup de 
moteurs demandent des compétences poussées dans des langages de program- 
mation natifs comme le C++ ou d'avoir de solides bases en mathématiques. 


Dans Unity, il est bien entendu recommandé de savoir ce qu'est une matrice 
ou un vecteur, mais ce n'est pas indispensable pour pouvoir créer un jeu 
simple. Grâce à l'éditeur, il suffit parfois de simplement ajouter un objet récu- 
péré dans l'Asset Store (le magasin virtuel de ressources autour d'Unity) et de 
le paramétrer directement dans l'éditeur, sans une seule ligne de code à écrire, 
afin de l'animer ou de le personnaliser. 


. Quels outils utiliser ? 


MonoDevelop 


Unity est configuré pour fonctionner avec MonoDevelop. Cet IDE (/ntegrated 
Development Environment) est fourni avec Unity et contient les fonctionnalités 
principales d'un éditeur de texte et il permet également de déboguer votre jeu. 


Pendant l'installation d'Unity, vous pouvez choisir de l'installer ou non si vous 
êtes sur Windows. 
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Si vous choisissez de l'installer, MonoDevelop sera ouvert automatiquement 
lorsque vous souhaitez ouvrir un script. Dans Unity, il est possible de désacti- 
ver cette association en allant dans le menu Edit - Preferences - External 
Tools - External Script Editor puis en choisissant l'IDE qui vous convient 
le mieux. 


Pour pouvoir déboguer votre application dans MonoDevelop, l'option Editor 
Attaching doit être cochée dans la même fenêtre que précédemment. Il faut 
aussi activer les options Development Build et Script Debugging dans les 
options de compilation, accessibles grâce au menu File - Build Settings. 


4.2 Visual Studio 


Une autre solution est d'utiliser Visual Studio pour remplacer MonoDevelop. 
Éditée par Microsoft, la version Visual Studio Community 2015 est entière- 
ment gratuite et propose un grand nombre de fonctionnalités et permet aussi 
l'ajout de plug-ins afin de gagner en productivité. Il est bien entendu possible 
de déboguer comme avec MonoDevelop, grâce aux Visual Studio Tools for 
Unity qui sont, depuis peu, fournis de base à l'installation d'Unity. 


Ces outils permettent de fournir des aides qui n'existent pas dans l'éditeur 
comme la fenêtre Unity Project Explorer qui affiche tous les fichiers et les 
dossiers d'un même projet Unity dans une seule hiérarchie. Le Shader Editor 
propose quant à lui une coloration syntaxique pour les shaders utilisés dans 
Unity (cf. Utilisation des assets graphiques et audio - Les shaders et maté- 
riaux). 


Nous vous recommandons d'utiliser cet IDE car il permet beaucoup plus de 
choses que MonoDevelop. 


5. Les bases du fonctionnement du rendu 


Unity fournit donc un moteur de jeu ayant sa propre boucle de jeu. Celle-ci 
est au cœur du moteur et c'est ce qui permet d'afficher des objets à l'écran. 


Prenons l'exemple d'un jeu en 3D, comme un RPG (Role Playing Game), ayant 
un monde riche avec des montagnes, des lacs, des routes mais aussi des per- 
sonnages, des lumières. 
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Comment savoir ce qu'il faut afficher à l'écran et comment savoir de quelles 
couleurs les afficher en prenant en compte les ombres, le champ de vision. ? 
Cela va donc être le travail du moteur de jeu de créer une frame, ce qui peut 
s'apparenter à une image, le plus rapidement possible en prenant en compte 
tous ces paramètres. 


La fréquence d'images générée (frame rate), qui se calcule en images par 
seconde, permet de rendre compte de la fluidité du rendu. Plus ce chiffre est 
élevé, plus l'animation semble limpide. Le cinéma utilise la norme de 24 
images par seconde et la télévision via les deux systèmes PAL (Europe) et 
NTSC (Japon et États-Unis) utilise respectivement 25 et 30 fps (frames per 
second). 


Un rapide calcul nous permet de comprendre qu'un cycle de rendu est quelque 
chose de très rapide (40 ms pour le cinéma). Une image doit donc pouvoir être 
générée le plus rapidement possible dans un jeu afin de gagner en fluidité et 
que l'expérience de l'utilisateur ne soit pas dégradée. 


Dans Unity, chaque objet ajouté dans une scène a son propre cycle de vie. Il 
peut être résumé en trois grandes étapes : 


— Init : l'objet est ajouté à la scène et ses propriétés sont initialisées. Il sera 
donc pris en compte dans la boucle de rendu globale à partir de ce moment- 
là. 

— Update : l'objet étant déjà créé, la boucle de rendu s'appuiera sur les compo- 
sants et les propriétés de celui-ci afin de l'afficher si besoin. Tout au long de 
cette étape, il est donc possible de modifier l'objet via des scripts personna- 
lisés. 

— End : l'objet est supprimé de la scène et ses ressources sont supprimées. Il ne 
sera plus pris en compte dans la boucle de rendu globale. 


Le moteur de jeu va donc prendre l'intégralité des objets actifs de la scène pour 
créer son image en prenant en compte un nombre de critères très important 
comme le champ de vision, la profondeur, la transparence, les matériaux, les 
lumières, les ombres, les effets. C'est ici que la magie opère et les utilisateurs 
n'ont heureusement pas besoin d'y toucher ! 
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Présentation de l’éditeur 


Unity propose un éditeur, aujourd'hui en version 5, permettant de créer des 
jeux ou applications en 2D et 3D. Il se compose principalement de cinq vues 
essentielles qui permettent de créer une scène de jeu, d'obtenir la liste des 
objets qui la composent, de pouvoir modifier ces éléments, de visualiser le ren- 
du final et enfin de naviguer dans l'arborescence du projet. 


La magie de l'éditeur intervient lors de l'appui sur le bouton Play situé en haut 
au centre de l'éditeur : le jeu se lance alors et tourne en direct à l'intérieur 
même de l'éditeur ! Cela vous permet de pouvoir manipuler en cours de fonc- 
tionnement les différents éléments de la scène et de voir comment se com- 
porte votre jeu. 


. Présentation de l'interface 


Les menus 


Comme la plupart des logiciels, l'éditeur dispose d'une série de menus et sous- 
menus permettant d'accéder rapidement à un ensemble de fonctionnalités. 


File Edit Assets GameObject Component Window Help 
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2.1.1 Menu File 


Les projets et les scènes 


Comme souvent dans ce genre de menu, on retrouve les fonctions permettant 
de créer un nouveau projet, d'ouvrir un projet existant ou de le sauvegarder. 
La même chose est possible au niveau des scènes composant votre jeu. 


New Scene CtrieN 
Open Scene Ctri+0 


Save Scene Ctris 
‘Save Scene as. Ctrks Shift+S 


New Project... 
Open Project. 
Save Project 
Build Settings... Ctri+Shift+B 
Build & Run Ctri+B 
Build in Cloud... 


Exit 


Les paramètres de compilation 


Le menu File permet aussi d'accéder à un sous-menu permettant d'éditer les 
options de compilation. Il est accessible grâce au raccourci [Ctrl]{[Shift] B ou 
via le menu File - Build Settings. Une fenêtre de configuration s'ouvre alors 
afin de permettre à l'utilisateur d'ajouter des scènes au projet et de sélection- 
ner la plateforme cible sur laquelle le jeu sera publié ainsi que ses paramètres 
associés. 
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Build Settings 


HRemarque 


Cet écran sera présenté plus en détail dans le chapitre traitant de la générar- 
tion des packages. 


La compilation dans le cloud 


Parallèlement à la compilation traditionnelle à partir de votre propre machine, 
il est possible de compiler directement via le cloud grâce à un service fourni par 
Unity : Unity Cloud Build Pro. Ce service permet de compiler, installer et tes- 
ter votre jeu automatiquement dès lors qu'un changement est détecté via 
votre gestionnaire de sources. 
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Ce livre n'a pas pour but de traiter des services annexes de Unity donc nous ne 
rentrerons pas plus dans les détails ; pour plus d'informations, consultez la 
page suivante : https://build.cloud.unity3d.com/. 


Menu Edit 


Les outils standards 


Le menu Edit rassemble toutes les fonctionnalités standards d'édition comme 
le Cut (Couper), Copy (Copier), Paste (Coller), Undo/Redo (Annuler/Réta- 
blir le changement), Duplicate (Dupliquer), Delete (Supprimer), Find 
(Rechercher), Select All (Sélectionner tout). Les raccourcis associés à ces 
actions sont aussi des plus classiques, pas de dépaysement à prévoir donc. 


Edit. Assets GameObject Component Win 
Undo Ctri+Z 
Redo CtreY 


Cut 


Copy 
Paste 


Ctri+X 
Ctri+C 
Ctri+W 


Ctri+D 
Shift+ Del 


Duplicate 
Delete 


Frame Selected 
Eock View to Selected 
Find 
Select Al 


Preferences... 
Modules... 


Ctri+P 
Ctri+Shift+P 
Ctrt+ Alt+P 


Sign in... 
Sign out 
Selection 
Project Settings 
Network Emulation 
Graphics Emulation 
Snap Settings. 
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Les préférences 
Les préférences générales 


Unity Preferences 


De haut en bas, les différents réglages de la rubrique General sont : 


— Auto Refresh : permet le rafraîchissement automatique du projet lors- 
qu'un changement extérieur est détecté, comme la modification d'un script. 


— Load Previous Project on Startup : permet de charger le dernier projet 
utilisé au lancement de l'éditeur. 


- Compress Assets on Import : permet de compresser automatiquement 
les assets (images, sons...) lors de leur importation dans le projet. 


- Disable Editor Analytics : permet de désactiver l'envoie des statistiques 
anonymes sur l'utilisation de l'éditeur pour permettre l'amélioration du 
produit par les équipes de développement. Cette option est uniquement 
utilisable pour les versions Pro. 
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— Show Asset Store search hits : permet d'activer l'affichage du nombre 
d'assets (payants et gratuits) trouvés dans l'Asset Store dans la fenêtre 
Project. 


— Veryfing Saving Assets : permet d'activer la vérification de la sauvegarde 
des assets lors de la fermeture de l'éditeur. 


- Editor Skin : permet de choisir le thème de l'éditeur entre la version 
Professional (gris foncé) et Personal (gris clair). 


— Enable Alpha Numeric Sorting : permet d'ajouter un bouton en haut à 
droite de la fenêtre Hierarchy afin de changer le tri des objets avec les 
options Transform (basé sur la position) et Alphanumeric (ordre alpha- 
bétique). 
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Les outils externes 


Unity Preferences 


De haut en bas, les différents réglages de la rubrique External Tools sont : 


— External Script Editor : permet de choisir l'application à utiliser pour 
ouvrir les fichiers scripts (Visual Studio, MonoDevelop.….). 


— External Script Editor Args (facultatif): permet de définir les arguments 
à passer au programme d'édition des scripts. La macro $ (File) sera rem- 
placée par le chemin d'accès du fichier à ouvrir. $ (Line) sera remplacé par 
la ligne du script à afficher une fois le fichier ouvert. 


— MonoDevelop Solution Properties : permet de définir si Unity peut 
ajouter les propriétés de MonoDevelop dans les fichiers de solution (.sin). 


— Editor Attaching : permet d'autoriser le contrôle du débogueur d'Unity via 
un script extérieur. 


— Image application : permet de définir quelle application utiliser pour ou- 
vrir les fichiers de type image. 
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- Revision Control Diff/Merge : permet de définir l'application à utiliser 
pour résoudre les conflits obtenus lors de l'utilisation de l'Asset Server. 


- Tizen SDK Location : permet de définir le chemin d'accès du dossier du 
SDK Tizen. 


— Android SDK Location : permet de définir le chemin d'accès du dossier du 
SDK Android. 


- JDK Location : permet de définir le chemin d'accès du dossier du JDK. 


Les couleurs 


Unity Preferences 


La rubrique Colors permet de modifier les couleurs de certains éléments d'affi- 
chage dans Unity. Il est par exemple possible de modifier la couleur du fond 
de l'éditeur quand le projet passe en mode Play en changeant la couleur Play- 
mode tints afin de différencier plus facilement les deux modes d'exécution. 
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Les raccourcis 


Unity Preferences 


La rubrique Keys vous permet de définir les touches de raccourcis afin d'acti- 
ver les différentes commandes de l'éditeur. Il est donc possible de changer le 
raccourci permettant de passer en mode Rotation (Tools/Rotate) ou bien de 
modifier les touches du mode FPS (View/FPS*) assignées par défaut à Z, Q, 
S, D, par les flèches directionnelles par exemple. 


Le mode FPS est utilisé lorsque l’on ajoute un personnage à la scène. Celui-ci 


est, par défaut, manipulable via les touches du clavier définies dans les options 
View/FPS*. 
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Le Global lllumination Cache 


Unity Preferences 


De haut en bas, les différents réglages de la rubrique GI Cache sont : 


— Maximum Cache Size (GB) : permet de définir la taille maximale que 
peut occuper le cache du système de GI (Global Illumination). La taille du 
dossier de cache doit, quand c'est possible, rester en dessous de la limite dé- 
finie. Périodiquement, un programme exécuté en tache de fond supprime les 
fichiers obsolètes afin de libérer de l'espace. 


— Custom cache location : permet de définir un emplacement personnalisé 
pour le cache GI. À noter que ce dossier est partagé entre tous les projets. 


— Cache compression : permet d'activer la compression en temps réel des fi- 
chiers de cache GI afin de réduire la taille de celui-ci. Il est recommandé de 
laisser activée cette option à moins de vouloir accéder aux données brutes. 


— Clean Cache : permet de supprimer l'intégralité des fichiers du cache. 
— Cache size : affiche la taille actuelle du cache GI. 
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— Cache FolderLocation : affiche l'emplacement du cache GI. 


Le cache serveur 


De haut en bas, les différents réglages de la rubrique Cache Server sont : 


— Use Cache Server : permet d'activer le serveur de cache. 


- IP Address : permet de définir l'adresse IP du serveur de cache. Accessible 
uniquement si l'option précédente est activée. 


Les modules 


La commande Modules affiche une fenêtre listant l'intégralité des modules 
chargés dans Unity ainsi que leurs numéros de version. Ils sont classés en deux 
catégories : Playback Engine, catégorie correspondant aux différentes plate- 
formes (comme Android, iPhone...) et Unity Extensions, catégorie corres- 
pondant à des extensions de l'éditeur (comme Unity Analytics, IL2CPP...). 
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Le mode Play 


Les commandes Play (Jouer), Pause (Pause) et Step (Étape) permettent res- 
pectivement de lancer le jeu dans l'éditeur afin de le tester directement, de 
mettre le jeu en pause et enfin d'avancer d'une frame afin de pouvoir tester 
plus finement le comportement du jeu. 


L'authentification 


En étant authentifié sur les serveurs de Unity, vous pourrez retrouver l’inté- 
gralité des achats effectués sur le store en ligne (Asset Store) mais ausi être 


. connecté aux différents services proposés par Unity (Analytics Pro, Cloud 


Build Pro, etc.). 


La gestion de l'authentification est possible via les items Sign in. et Sign 
out. Le travail hors ligne, ou non connecté, est tout à fait possible, tout 
comme le changement d'utilisateur. 


Les sélections 


L'éditeur permet de sauvegarder votre sélection actuelle sous forme de rac- 
courci afin de pouvoir la réutiliser plus rapidement. Il est possible d'enregistrer 
un maximum de dix sélections différentes en mémoire. 


Par exemple, pour enregistrer la sélection courante dans le raccourci numéro 


Sélectionnez Edit - Selection - Save Selection 7 ou utilisez le raccourci 
[Ctrl] [Alt] 7. 


Pour charger la sélection numéro 7 : 


Sélectionnez Edit - Selection - Load Selection 7 ou utilisez le raccourci 
[Ctrl][Shift] 7. 
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Les paramètres du projet 
Le menu Project Settings permet d'accéder à différents réglages liés au projet. 


Ctr+F 


Select All Ctri+A és 


. | Tags and Layers 
Preferences... : Audio 


Modules... Time 


Play Ctri+P Player 

Pause Ctri+Shift+P Physics 

Step CtrAlt+P Physics 2D 

| Quality 

Graphics 

Network 

Editor 

Script Execution Order 


Sign in. 
Sign out 
Selection 


Voici la liste des groupes de paramètres disponibles : 


— Input : permet de modifier les entrées utilisateurs (axes, flèches direction- 
nelles...) permettant le déplacement ou les actions dans le jeu. Il est préfé- 
rable d'utiliser ces entrées virtuelles lors de vos développements plutôt que 
d'utiliser une touche individuelle car le joueur peut vouloir modifier l'asso- 
ciation d'une touche pour une action spécifique (utiliser la touche [Ctrl] 
pour recharger plutôt que la touche R par exemple). 


- Tags and Layers : permet de définir le nom des étiquettes (1485) et couches 
(layers) personnalisées. Les étiquettes peuvent être assimilées à des mar- 
queurs permettant d'identifier des objets dans le projet. Les couches sont 
utilisées pour créer un ensemble d'objets partageant les mêmes caractéris- 
tiques. On les utilise pour limiter le nombre d'éléments sur lesquels appli- 
quer une opération (par exemple de raycasting). Les huit premières couches 
ne sont pas modifiables tandis que les couches suivantes Le sont. 
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Remarque 


Le Raycasting, ou lancer de rayon, est une technique permettant de créer un 
rayon fictif qui s'apparente à une droite qui partirait de notre œil vers un pixel 
défini de l'écran. Ce rayon va passer à travers chacun des objets de la scène 
afin de déterminer les collisions ainsi que la couleur à afficher à l'écran en 
fonction du premier objet rencontré. 


Il est aussi possible de définir un ordre de visualisation des couches (Sorting 
Layers) dans un système bidimensionnel. Cela définit l'ordre de superposi- 
tion des sprites (images, ensemble d'images) au niveau de la profondeur (axe 
Fa 

— Audio : permet de gérer les paramètres généraux de l'audio du jeu comme 
le volume maximum, le mode de haut-parleur par défaut (Mono, Stereo, 
Raw.…). 


— Time : permet de gérer différents réglages liés au contrôle du temps dans 
votre application. 


Remarque 


En manipulant ces paramètres, il est possible de mettre le jeu en pause en mo- 
difiant la valeur du Time Scale à zéro. 


. — Player : permet de gérer les paramètres liés aux plateformes ciblées. Nous 


verrons dans un autre chapitre à quoi servent ces paramètres et comment ils 
fonctionnent. 


— Physics : permet de gérer tous les paramètres liés au moteur physique 3D. 
Le changement de la gravité, la modification des couches pouvant entrer en 
collisions ou bien l'attribution d'un matériau par défaut, sont autant de ré- 
glages possibles. 


— Physics 2D : permet de gérer tous les paramètres liés au moteur physique 
2D 


— Quality : permet de définir les différentes qualités graphiques du jeu dispo- 
nibles en fonction du type de plateforme. Parmi les réglages possibles, on 
retrouve l'anti-aliasing (qui permet de lisser les contours des objets), les 
ombres, le système de particules ou encore le LOD (Level Of Details, permet- 
tant de définir le niveau de détail d’un objet en fonction de sa taille à 
l'écran). 
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— Graphics : permet de définir les paramètres d'optimisation et de customi- 
sation graphiques. Ils sont généralement réservés aux développeurs confir- 
més ayant de bonnes connaissances sur le fonctionnement des shaders. 


— Network : permet de modifier les paramètres généraux lors de la création 
d'un jeu multijoueur : le niveau de détail des messages envoyées à la console 
(Off, Informational, Full) et le nombre de fois par seconde où les données 
sont envoyées sur le réseau. 


— Editor : permet de gérer les options d'utilisation de l'éditeur. Cela englobe 
plusieurs paramètres comme le type d'appareil utilisé pour les tests à dis- 
tance (Android, iOS ou aucun), le choix du gestionnaire de code source (uni- 
quement pour les licences Pro), le type de sérialisation des assets (Force 
Binary, Force Text ou Mixte) ou le choix du mode de l'éditeur par défaut 
lors de la création d'un nouveau projet (2D ou 8D). 


- Script Execution Order : permet de modifier l'ordre d'exécution des 
scripts de l'application. Il est recommandé de ne rien modifier à moins d'être 
sûr des modifications effectuées. 


L'émulation du réseau 


Le menu Network Emulation sert à sélectionner le type de réseau à simuler 
lorsque l'on teste le jeu. Plusieurs réglages prédéfinis sont disponibles afin de 
tester rapidement le comportement d'un jeu avec un type de connexion don- 
né. 


Project Settings 


None 
Graphics Emulation È Broadband 


DSL 
ISDN 
Dial-Up 


Snap Settings. 
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L'émulation graphique 


Le menu Graphics Emulation autorise le changement de Shader Model 
(ensemble de caractéristiques liées aux shaders au niveau de la carte gra- 
phique) afin de tester le fonctionnement de l'application dans une configura- 
tion spécifique. La liste des émulateurs disponibles dépend de la plateforme 
ciblée, elle sera donc différente dans le cas d'un jeu sur PC que dans celui d'un 
jeu sur Android. 


Project Settings 


Network Emulation 


No Emulation 
Shader Model 3 
Shader Model 2 


Snap Settings... 


Les paramètres d'alignement 


Le menu Snap Settings permet de modifier les valeurs d'accrochage sur les 
différents axes (X, Y et Z) et de gérer les axes ou l'accrochage des objets doit 
être actif. 


Snap settings 


© Editions ENI - All rights reserved 


45 


Éditeur, pièce maîtresse 
Chapitre 2 


2.1.3 Menu Assets 


Le menu Assets regroupe les fonctionnalités touchant aux ressources de 
l'application (images, scripts, matériaux). 


Assets | GameQObject Component Windo 
Create > 
Show in Explorer 
Open 
Delete 


Import New Asset. 


Import Package > 
Export Package... 


Find References In Scene 
Select Dependencies 


Refresh 
Reimport 


Ctri+R 


Reimport Al 


Run API Undater.. 


Open C# Project 


— Create : permet de créer différents types d'éléments dans le projet comme 
un simple répertoire, un script C# ou une animation. 


— Show in Explorer : permet d'ouvrir l'explorateur de fichier à l'emplace- 
ment du fichier sélectionné. Si aucun élément n'est sélectionné, l'explora- 
teur s'ouvrira au niveau de la racine du projet. 


— Open : permet d'ouvrir l'élément sélectionné si cela est possible. 
— Delete : permet de supprimer l'élément sélectionné. 


— Import New Asset : permet d'importer un asset dans le projet à partir d'un 
emplacement spécifique. 
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— Import Package : permet d'importer un package dans le projet à partir d'un 
emplacement spécifique ou de charger un package prédéfini. 


Custom Package... 
Export Package. ns 
Find References In Scene 
Select Dependencies 


2D 


Cameras 


ne Characters 
art CtR CrossPlatforminput 


Reimport Effects 
Environment 
ParticleSystems 
__._ . Prototyping 
Sync MonoDevelop Project Utility 

Vehicles 


Reimport All 


Run API Updater.. 


— Export Package : permet de créer et de sauvegarder un package à partir 
d'une sélection d'éléments. Tous les éléments cochés de la liste formeront un 
nouveau package pouvant être chargé dans un autre projet. 


Exporting package 
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— Find References In Scene : permet de rechercher et de filtrer l'affichage 
des objets de la scène à l'élément sélectionné. 


- Select Dependencies : permet d'afficher toutes les dépendances de 
l'élément sélectionné (tous les objets d'une scène par exemple). Cela est très 
utile pour faire le ménage dans les assets pour les gros projets. 


— Refresh : permet de mettre à jour l'éditeur pour prendre en compte les 
fichiers qui ont pu être ajoutés, supprimés ou modifiés sans passer par 
l'éditeur et qui n'ont pas été pris en compte par Unity. 

— Reimport : permet de réimporter un asset, ce qui peut, dans le cas d'une 
image ou d'un son par exemple, déclencher la compression automatique de 
celui-ci. 


— Reimport All : permet de réimporter la totalité des assets du projet. Cette 
opération peut être très longue et n'est recommandée qu'en cas d'erreur 
sérieuse ou de fichiers corrompus. 


— Run API Updater : permet de lancer la mise à jour automatique de vos 
scripts utilisant l'ancienne API (< version 5) pour les passer à la nouvelle 
version. 


Voici un exemple démontrant le rôle de ce menu : 
Ancienne API : 


void Start () 


{ 


rigidBody.velocity = Vector3.up; 


} 
Nouvelle API : 


void Start () 


{ 


GetComponent<Rigidbody>().velocity = Vector3.up; 


} 
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— Open C# Project : permet de forcer la synchronisation des fichiers entre 
MonoDevelop et Unity. 


2.1.4 Menu GameObject 


Le menu GameObject regroupe toutes les fonctionnalités touchant aux 
objets du projet de la création à la manipulation dans la scène. 


| GameObject Component Window Help 


Create Empty Ctri+Shift+N 
Create Empty Child Alt+Shift+N 
3D Object > 
2D Object > 
Light > 


Audio 
UI 
Particle System 


Camera 


Center On Children 


Make Parent 
Clear Parent 
Apply Changes To Prefab 


Break Prefab Instance 


MyCustomMenu 
Bet as first sibling Ctri+= 
Set as last sibling Ctrk+- 
Ctrie Alter 
Align With View Ctri+Shift+F 
Align View to Selected 


Move To View 


Alt+Shift+ A 


Toggle Active State 


— Create Empty : permet de créer un GameObject sans composant. 


— Create Empty Child : permet de créer un GameObject sans composant et 
fils de l'élément sélectionné. 
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— 3D Object : permet d'accéder au menu de création d'un objet 3D prédéfini 
(sphère, cube, arbre.….). 


— 2D Object : permet d'accéder au menu de création d'un objet 2D prédéfini 
(sprite). 

— Light : permet d'accéder au menu de création d'objets liés à la lumière. 

— Audio : permet d'accéder au menu de création d'objets audio. 

— UI : permet d'accéder au menu de création d'objets d'interface utilisateur. 

— Particle System : permet de créer un système de particules. 

— Camera : permet de créer une caméra. 


- Center On Children : permet de modifier la position de l'élément parent 
de façon à ce qu'il soit centré par rapport à ses enfants. 


— Make Parent : permet de rendre l'élément sélectionné comme parent. 
— Clear Parent : permet de supprimer le lien de parenté d'un objet. 


— Apply Changes To Prefab : permet de sauvegarder tous les changements 
effectués sur un prefab (objet préfabriqué). 


— Break Prefab Instances : permet d'enlever la relation d'un objet avec son 
prefab. 


— Set as first sibling : permet de mettre l'objet sélectionné en haut de la liste 
(premier élément) dans la hiérarchie des frères et sœurs. 


— Set as last sibling : permet de mettre l'objet sélectionné en bas de la liste 
(dernier élément) dans la hiérarchie des frères et sœurs. 


— Move To View : permet de modifier la position de l'objet sélectionné et de 
la remplacer par la position de la projection de la vue courante dans la 
fenêtre Scene. 


- Align With View : permet de modifier la position de l'objet sélectionné et 
de la remplacer par la position de la vue courante dans la fenêtre Scene. 


— Align View to Selected : permet d'aligner la vue de la fenêtre Scene en 
fonction de l'objet sélectionné sur le plan 2D (X, Y). 


- Toggle Active State : permet d'activer ou de désactiver l'élément sélection- 
né de manière à ce qu'il ne soit plus pris en compte dans la scène. 
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2.1.5 Menu Component 


Ce menu permet d'ajouter des composants prédéfinis à l'objet sélectionné. 
Plusieurs catégories sont disponibles en fonction du type des composants. On 
retrouve les groupes suivants : Mesh, Effects, Physics, Physics 2D, Navi- 
gation, Audio, Rendering, Layout, Miscellaneous, Event, Network, UI 
et Scripts. 


_ Component | Visual Studio Tools Windo 


ädd.. CtrteShift+A 
Mesh 

Effects 
Physics 
Physics 2D 
Navigation 
Audio 
Rendering 
Layout 
Miscellaneous 
Event 
Network 

ui - 

Scripts 


L'ensemble de ces composants seront détaillés dans le chapitre Le GameObject 
et ses composants. 


2.1.6 Menu Window 


Le menu Window permet de gérer l'affichage des différentes fenêtres de l'édi- 
teur. L'entrée de menu Layouts donne accès aux mises en forme sauvegardées 
de l'éditeur, ce qui englobe celles prédéfinies ainsi que celles que l'on a pu créer. 


Des raccourcis ([Ctrl] 1 à [Ctrl] 9) sont prévus afin d'afficher facilement les 
fenêtres les plus couramment utilisées. 


© Editions ENI - Al rights reserved 


Éditeur, pièce maîtresse 
Chapitre 2 


Ctri+Tab 
Previous Window Ctri+Shift+ Tab 


Layouts 


Scene Ctri+1 
Game Ctri+2 
Inspector Ctri+3 
Hierarchy Ctri+4 
Project Ctri+5 
Animation Ctri+6 
Profiler Ctri+7 
Audio Mixer Ctri+8 
Asset Store Ctri+9 
Version Control 

Animator Parameter 

Animator 

Sprite Packer 

Lighting 

Occlusion Culling 

Frame Debugger 

Navigation 


Console Ctri+ShiftrC | 


2.1.7 Menu Help 


Dans le menu Help, on retrouve de nombreux liens vers la documentation 
officielle (Unity Manual et Scripting Reference) ainsi que des liens vers les 
différentes parties du site officiel d'Unity : Unity Connect pour les services, 
Unity Forum et Unity Answers pour la partie communautaire, Unity 
Feedback pour faire des retours sur les produits. 


Le sous-menu Manage License ouvre la fenêtre de gestion des licences. Cela 
permet d'activer une licence, de la retourner ou d'activer une licence manuel- 
lement. 
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ne 


Pour vérifier la présence de nouvelles mises à jour, utilisez le sous-menu 
Check for Updates. De la même manière, pour connaître les informations 
sur la version courante de l'éditeur, utilisez le sous-menu About Unity. 


Help. 
About Unity.. 
Manage License. 


Unity Manual 
Scripting Reference 


Unity Connect 
Unity Forum 
Unity Answers 
Unity Feedback 


Check for Updates 
Download Beta... 


Release Notes 
Report a Bug... 


2.2 La vue Scene 


2.2.1 Présentation de la vue 


Dans ün jeu vidéo, on retrouve la plupart du temps différents écrans qui 
s'enchaînent avec ou sans transitions. Ceux-ci peuvent être de plusieurs 
sortes : un écran de chargement, un écran de paramétrage des options du jeu, 
l'écran de jeu en lui-même... Dans Unity, cela se traduit par un composant 
appelé scène. 


L'éditeur propose une vue spécifique pour la création d'une scène. Cette vue 
permet de visualiser tous les objets composant celle-ci avec la possibilité de les 
manipuler directement à la souris ou au clavier. 
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Manipulation des objets et du point de vue 


Plusieurs modes de sélection sont disponibles permettant de changer les inte- 
ractions avec la souris ou un stylet. Ceci se traduit par le menu suivant situé 
au-dessous du menu général à gauche : 


De gauche à droite : déplacement de l'angle de vue, translation des objets, 
rotation des objets, agrandissement des objets et modification des colliders 
(cf. Le moteur physique - Le composant Collider). 


De ces différents modes de sélection résultent les manipulations suivantes : 


— Sélectionner un objet : via un clic gauche. Disponible dans tous les modes 


excepté celui du déplacement de l'angle de vue Es 


— Dans le mode translation Li trois axes de couleurs différentes apparais- 
sent ainsi que trois plans, correspondant aux trois dimensions. 
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— Dans le mode rotation Et, trois cercles de couleurs différentes apparais- 
sent correspondant aux trois dimensions. 


— Dans le mode redimensionnement Le] trois axes ponctués par un cube à 
leurs extrémités de couleurs différentes apparaissent correspondant aux 
trois dimensions. 
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Dans le cas d'un projet 2D, seulement deux axes, plans ou cercles seront 
affichés. 


Remarque 
La vue Scene affiche en haut à droite le repère selon les trois axes X, Y et Z. En 
cliquant sur l'un des axes, la scène s'affichera automatiquement perpendicu- 


laire par rapport à celui-ci. C'est un moyen rapide de changer d'angle de vue 
sans le faire à la souris ou la précision reste limitée. 


— Déplacer un objet selon un axe : dans le mode translation, sélectionnez l'axe 
souhaité via un clic gauche et déplacez la souris en gardant le bouton de la 
souris enfoncé. Relâchez le bouton pour arrêter le déplacement. 


— Déplacer un objet selon un plan : dans le mode translation, sélectionnez le 
plan souhaité via un clic gauche et déplacez la souris en gardant le bouton 
de la souris enfoncé. Relâchez le bouton pour arrêter le déplacement. 


— Pivoter un objet selon un axe : dans le mode rotation, sélectionnez le cercle 
souhaité via un clic gauche et déplacez la souris en gardant le bouton de la 
souris enfoncé. Relâchez le bouton pour arrêter le déplacement. 


— Agrandir/diminuer un objet selon un axe : dans le mode redimensionne- 
ment, sélectionnez le cube à l'extrémité de l'axe souhaité via un clic gauche 
et déplacez la souris en gardant le bouton de la souris enfoncé. Relâchez le 
bouton pour arrêter le déplacement. 


— Déplacer le point de vue : dans tous les modes, maintenez appuyé le bouton 
du milieu (ou celui de la molette) et déplacez la souris. Relâchez le bouton 
pour arrêter le déplacement. 

— Faire pivoter le point de vue : dans tous les modes, maintenez appuyé le bou- 
ton droit et déplacez la souris. Relâchez le bouton pour arrêter le déplace- 
ment. 


— Zoomer : dans tous les modes, tournez la molette de la souris. 


Remarque 


Le repère propose deux types de vue : perspective et isométrique. Pour passer 
d'un mode à l'autre, il suffit de cliquer sur le texte en dessous du repère. 
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La vue perspective affiche les objets de la scène en gardant la perspective, 
c'est-à-dire que le même objet sera plus petit s’il se trouve plus loin. La vue iso- 
métrique affiche les objets de manière uniforme, c'est-à-dire sans prendre en 
compte la profondeur ou l'éloignement. 


2.2.3 Barre d'outils 


En haut se situe une barre proposant plusieurs types d'actions possibles 
comme des filtres d'affichage pour ne visualiser à l'écran que certains types 
d'objet ou encore une recherche rapide. 


À Scene 


Sh 


De gauche à droite on retrouve : 


— Un menu permettant de sélectionner le type d'affichage des objets. Trois 

modes sont disponibles : 

— Shaded (ombragé) : c'est le mode par défaut. Il permet d'obtenir un rendu 
proche de la réalité. 

— Wireframe (filaire) : ce mode permet d'afficher les objets sous forme de 
structure de type fil de fer. 

— Shaded Wireframe (filaire ombragé) : le dernier mode est la combinai- 
son des deux modes précédents. 
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— Un bouton F#! permettant de passer en mode 2D, ce qui a pour effet de 
bloquer la rotation du point de vue sur les axes X et Y. 


- Un bouton pour activer ou non les objets de type Light (lumière). 
L'éclairage de la scène est alors modifié en conséquence. 


— Un bouton pour activer ou non les sons dans la scène. 


-— Un menu pour activer/désactiver l'affichage de la Skybox (cf. Utili- 
sation des assets graphiques et audio - La caméra), du brouillard ou des 
lumières très lumineuses. 
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— Un menu permettant de modifier l'affichage des Gizmos (cf. Personnaliser 
l'éditeur pour ses besoins) et de sélectionner l'ensemble des types à afficher 
dans la scène. 
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2.3 La hiérarchie des objets 


2.3.1 Présentation 


Cette vue est étroitement liée à la vue précédente par le fait qu'elle répertorie 
l'ensemble des objets de la scène de façon hiérarchique. L'introduction du 
concept de hiérarchie induit de fait des relations père-fils au niveau des élé- 
ments de la scène. Il va donc être possible de créer un objet parent appelé 
Corps comprenant deux objets fils Jambe, deux objets fils Bras et un objet 
fils Sphere. 


2.3.2 Manipulation des objets 


Il est possible de réaliser toutes les opérations courantes dans la hiérarchie 
comme le copier/coller d'un élément ou d'un ensemble d'éléments ou de les 
déplacer via une opération de glisser/déposer. 
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Au clic droit dans la vue, un menu vous permet d'ajouter de nouveaux élé- 
ments à la scène en s'appuyant sur des composants de base : 


— Create empty : permet de créer un objet vide sans composant attaché (voir 
chapitre Le GameObject et ses composants). 


— 3D Object : permet de créer un objet en trois dimensions tels un cube, une 
sphère, un cylindre, un terrain. 


— 2D Object : permet de créer un objet en deux dimensions tels un cercle ou 
un carré en se basant sur un sprite. 


- Light : permet de créer une lumière suivant différents profils (direction- 
nelle, réflexion.….). 


— Audio : permet de créer un objet afin de contrôler une source audio. 

— UI : permet de créer un objet servant à l'interface utilisateur (bouton, texte, 
image.….). 

— Particle System : permet de créer un système de particules. 

— Camera : permet d'ajouter une caméra. 


Filtrage des objets 


Dans la barre d'outils de la vue, on retrouve un champ de saisie permettant de 
filtrer par nom les objets à afficher dans la hiérarchie. Cela ne provoque aucun 
changement visuel dans la scène, cela permet seulement de pouvoir rechercher 
rapidement un objet grâce à son nom dans une liste d'objets qui peut vite 
devenir très importante. 


Remarque 


Dans un projet d'envergure, le nombre d'objets par scène peut dépasser faci- 
lement plusieurs centaines. Il est donc important de bien hiérarchiser ses élé- 
ments et de se fixer une convention de nommage afin de pouvoir retrouver 
un objet aisément. 
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La vue de rendu 


Présentation 


Cette vue affiche le rendu de la scène telle qu'elle est censée s'afficher une fois 
le jeu compilé et lancé. Chaque modification de la scène, que ce soit en mode 
édition (le bouton Play n'étant pas actif) ou en mode exécution (le bouton 
Play étant actif), est répercutée immédiatement dans la vue de rendu. 


Modification de la résolution 


Il est possible de modifier le ratio d'affichage de la vue afin de tester différentes 
résolutions. Le changement n'entraîne aucun arrêt du jeu si le mode Play est 
actif et la prise en compte est immédiate. Par défaut, la valeur Free Aspect 
est affectée. Le ratio d’affichage est celui de la fenêtre Game courante dans 
l'éditeur. 


Statistiques de rendu 


Des statistiques sont aussi disponibles dans la barre d'outils sur la partie 
droite. Elle affiche des informations comme le nombre d'images par seconde 
(fps), le volume audio ou encore le nombre de joueurs connectés dans le cas 
d'un jeu multijoueur. 
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2.5 La hiérarchie du projet 


Cette vue ressemble fortement à un explorateur de fichier que l'on peut 
retrouver sur Windows avec deux panneaux spécifiques : l'un servant à sélec- 
tionner le dossier à explorer et l'autre à afficher l'ensemble des fichiers et dos- 
siers le composant. 


L'éditeur introduit un concept de favoris permettant de retrouver facilement 
un certain nombre d'éléments selon leurs types, leurs noms ou leurs labels. 
Quatre favoris sont enregistrés de base : 

— All Materials : permet de récupérer tous les matériaux. 

— All Models : permet de récupérer tous les modèles. 

— All Prefabs : permet de récupérer tous les objets préfabriqués. 

— All Scripts : permet de récupérer tous les scripts (C# ou UnityScript). 
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Bien entendu, la création d'un favori personnalisé est tout à fait possible. Pour 
cela, il suffit de sélectionner un type et/ou un tag et/ou un nom et de cliquer 
sur le bouton en forme d'étoile en haut à droite du panneau. Entrez ensuite un 
libellé et le tour est joué. 


HRemarque 


N'hésitez pas à créer vos propres favoris et à supprimer les existants si vous ne 
vous en servez pas. Cela peut avoir un gain de productivité intéressant dans 
le cas d'un projet conséquent. 


2.6 La console 


Comme dans un IDE (/ntegrated Development Environment), un panneau de 
console permet d'afficher l'intégralité des messages utiles pour l'utilisateur. On 
retrouve les messages informatifs, d'erreurs (de syntaxe, de compilation...) 
mais aussi les messages personnalisés que l'on a nous-mêmes demandé à être 
affichés à partir de nos scripts. Toute cette partie sera approfondie plus tard 
dans le chapitre Le système de scripting. 
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2.7 L'Inspector 


2.7.1 


Le dernier panneau est étroitement lié à la scène puisqu'il permet de visualiser, 
modifier, créer ou supprimer les propriétés des objets de celle-ci. Lors d'une ses- 
sion de test de votre jeu, l'éditeur est toujours accessible et ses propriétés sont 
modifiables à la volée, c’est-à-dire qu'il n'est pas nécessaire de relancer le jeu 
pour prendre en compte les ajustements : tout est pris en compte immédiate- 
ment | 


Chaque objet contient des propriétés de base, que ce soit un objet vide ou 
complexe, plus des composants attachés à celui-ci. Afin de visualiser 
l'ensemble de ces informations, il suffit de sélectionner un élément de la scène 
en cliquant dessus, quel que soit son type. Une fois sélectionné, voyons ce que 
nous affiche l'Inspector. 


Les propriétés de base 


De haut en bas et de gauche à droite, on retrouve tout d'abord une zone conte- 
nant le type d'icône qui sera affichée dans la scène afin d'identifier rapidement 
le type de l'objet. 
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Vient ensuite une case à cocher qui permet d'activer ou non l'objet. Si la case 
est activée, l'élément sera actif et pourra être affiché dans la scène ; dans le cas 
contraire, il ne sera pas visible. 


On trouve ensuite le nom de l'objet qui pourra être utilisé plus tard dans un 
script afin de le retrouver. Ce nom est le même que celui qui s'affiche dans le 
panneau hiérarchie. 


La case à cocher qui suit (Static) sert à définir l'objet comme statique ; autre- 
ment dit, à indiquer au moteur que cet objet ne bougera pas dans la scène. 
Cela permet d'obtenir des optimisations lors des calculs de lumière, de colli- 
sion. Une liste permet de choisir quels systèmes doivent prendre en compte 
cette information. 


Everything 
Lightmap Static 
Occluder Static 


Batching Static 
Navigation Static 
Occludee Static 

Off Mesh Link Generation 
Reflection Probe Static 
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Pour cela, l'éditeur propose deux modes Everything et Nothing qui, respec- 
tivement, activeront tous les modules ou aucun module. Pour un choix plus 
fin, il suffit de sélectionner les systèmes parmi la liste suivante : 


- Lightmap Static : le système qui gère l'éclairage avancé. 
— Occluder Static et Occludee Static : le système qui gère l'optimisation du 


rendu en se basant sur la visibilité des objets à partir de la position de la ca- 
mera. 


- Batching Static : le système qui gère l'optimisation du rendu des objets 
contenus dans un objet plus grand. 


- Navigation Static : le système qui permet aux personnages de négocier les 
obstacles dans la scène. 


- Off Mesh Link Generation : le système de navigation qui établit les 
connexions entre les zones discontinues de la scène. 


- Reflection Probe Static : le système qui enregistre une vue sphérique de 
ses environs dans toutes les directions. 


En dessous de ce premier bandeau se situe une première liste (Tag) permet- 
tant de sélectionner un tag pour l'objet. Le tag correspond à une catégorie ou 
une information spécifique que le développeur peut affecter ou non à l'élé- 
ment afin de faciliter sa récupération et son utilisation dans un script. 


La liste de droite (Layer) permet de sélectionner le type de layer auquel sera 
associé l'objet. Les layers sont le plus souvent utilisées par les caméras afin de 
rendre seulement une partie de la scène. Ils sont aussi utilisés au niveau des 
lumières pour éclairer uniquement une partie de la scène. Mais ils peuvent 
également être utilisés dans une opération de raycasting (lancer de rayon) 
pour ignorer sélectivement certains collisionneurs ou pour créer des collisions. 


HRemarque 


Il est possible de créer son propre tag ou layer en sélectionnant le dernier élé- 
ment de chacune des listes déroulantes. Une fenêtre d'édition apparaîtra afin 
de pouvoir en ajouter, modifier ou supprimer. 
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2.7.2 Les composants de base 


Chaque objet est créé avec une série de propriétés attachées de type Trans- 
form ou RectTransform : on appelle cela un composant. Tout ceci sera 
détaillé plus tard dans le livre, sachez simplement qu'il est possible d'ajouter 
des composants de différents types à chacun des GameObijects (objets du jeu 
ajoutés dans la scène). Les seuls composants obligatoires sont les deux cités 
précédemment mas ils ne peuvent pas cohabiter. 


Le composant Trans form sera utilisé dans la majorité des cas. Il sert à définir 
la position, rotation et la taille de l'objet basé sur un repère propre au 
GameObject et sur les axes X, Y et Z. Pour une sphère, Le repère sera placé au 
centre de celle-ci. Les valeurs de la position, rotation et de la taille de la 
Transform sont mesurées de manière relative par rapport au Transform de 
l'objet parent. Si aucun parent n'est présent, le repère global appelé World 
Space sera utilisé afin de calculer les valeurs des propriétés. 


67 


68 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Le composant RectTransformest le penchant 2D de Transform. Il est uti- 
lisé principalement pour la définition des objets constituant l'interface utilisa- 
teur. Pour comprendre le fonctionnement, il suffit de comparer les deux 
composants ensemble : quand l'un, Transform, représente un point, l'autre, 
RectTransform, représente un rectangle où l'on peut placer un élément de 
l'UT. Si l'objet contient un parent du même type, le composant enfant peut 
aussi définir comment il doit être positionné par rapport à son parent. 


HRemarque 


Il est possible d'utiliser des aides de placement en cliquant sur l'aide visuelle en 
haut à gauche dans un composant RectTransform. Cela permet de placer 
automatiquement votre élément de différentes façons : centré horizontale- 
ment, aligné à gauche, aligné en haut et centré verticalement... 
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2.7.3 Exposer des propriétés à travers l'Inspector 


Comme écrit précédemment, nous verrons en détail en quoi consiste un com- 
posant plus tard dans un autre chapitre, donc nous ne nous attarderons pas 
sur les différents types de composant qui existent ni sur la manière d’en créer 
ou d’en ajouter. Nous allons nous concentrer sur l'édition des propriétés d'un 
composant dont les valeurs peuvent être bien différentes. 


HRemarque 


Nous parlons ici de propriétés au sens Unity car étant visibles dans l‘Inspector, 
bien qu'il s'agisse de variables et non propriétés au sens C#. 


Pour simplifier, le composant est constitué d'une ou plusieurs propriétés 
pouvant représenter un nombre, une chaîne de caractères, une référence à un 
GameObject, un matériau, etc. Un composant n'est ni plus ni moins qu'une 
classe C# ou JavaScript dont les propriétés sont exposées à travers l'Inspector 
afin de pouvoir les modifier dans l'éditeur. 
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Création d'un composant personnalisé à partir d'un script : GameBehar- 


vior.cs 


using UnityEngine; 


public class GameBehavior : MonoBehaviour 


{ 


} 


private int myPrivatelnt; 
private string myPrivateString; 
public int MyPublicint; 


[Range(0, 100)] 
public int MyPublicRangelnt; 


public string MyPublicString; 
public string[] MyPublicStrings; 
public GameObject MyPublicGameObject ; 
public enum EnumType 
{ 

Typel, 


Type2 


} 


public EnumType MyPublicEnumType; 


Dans ce script, plusieurs propriétés sont déclarées publiques (MyPublicInt, 
MyPublicStrings et MyPublicGameObject), tandis que d'autres sont 
privées ( myPrivatelnt et _myPrivateString). Dans l'Inspector, celles 
définies en publiques seront visibles et éditables, les autres ne le seront pas. 
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On note que l'Inspector se base sur le type de la propriété afin d'afficher un 
contrôle spécifique dans son interface pour permettre d'éditer plus facilement 
la valeur. 


- My Public Int : 
H public int MyPublicint; 


Les propriétés de type nombre (int, float, double...) sont présentées 
sous la forme d'un champ de saisie libre. Il sera impossible de saisir autre 
chose qu'un nombre. 


— My Public Range Int 


[Range (0,100)] 
public int MyPublicRangelnt; 


Il est possible d'utiliser des attributs afin de modifier le contrôle de saisie de 
l'Inspector. Dans notre exemple, on définit un attribut de type Range pour 
faire savoir à l'éditeur que le nombre ne pourra pas dépasser une borne mi- 
nimale (dans notre cas 0) et une borne maximale (dans notre cas 100). 


Cela a pour effet de passer d'un contrôle de saisie libre à un contrôle de type 
slider. 


— My Public String : 
H public string MyPublicString:; 


Les propriétés de type texte (string) sont présentées sous la forme d'un 
champ de saisie libre sans limitation. 
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— My Public Strings : 
public string[] MyPublicStrings; 


Les tableaux sont présentés sous la forme de liste composée de contrôle dé- 
pendant du type de la liste. Il est possible d'avoir plusieurs niveaux de liste 
imbriqués. 

- My Public Game Object : 

public GameObject MyPublicGameObject ; 


Le GameObject, comme d'autres types d'objets complexes, est représenté 
sous la forme d'un champ de type Picker. En effet, le but de celui-ci est de 
créer la relation avec un autre objet ou composant c'est pourquoi il suffit de 
faire une action de glisser/déposer dans le champ pour créer le lien. Une 
autre façon de faire est de cliquer sur l'icône en forme de rond sur la droite 
pour afficher une fenêtre proposant une liste d'éléments pouvant être asso- 
ciés. 

Il n'est pas possible d'associer un objet ne correspondant pas au type deman- 
dé. Le lien ne sera pas créé, ce qui permet de s'assurer du bon fonctionne- 
ment. Attention toutefois, si vous supprimer un élément actuellement 
attaché dans un composant, la liaison sera elle aussi supprimée ! 


- My Public Enum Type : 


public enum EnumType 


{ 
Typel, 
Type2 


} 


public EnumType MyPublicEnumType ; 


Les propriétés de type Enum sont présentées sous la forme d'une liste dérou- 
lante. 
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HRemarque 


Il existe un mode permettant d'afficher les propriétés déclarées privées sans 
pour autant avoir la possibilité de les éditer. Pour les rendre accessibles, il suffit 
de cliquer tout en haut du panneau sur l'icône la plus à droite (à droite du ca- 
denas) pour passer en mode Debug. Pour revenir avec le fonctionnement 
normal, il suffit de sélectionner le mode Normal. 
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Personnaliser l'éditeur pour ses besoins 


Personnaliser la disposition des vues 


Il est possible d'utiliser des dispositions de vues prédéfinies fournies de base 
par l'éditeur. Pour cela, il suffit de cliquer sur le deuxième bouton nommé 
Default en haut à droite dans la barre d'outils de l'éditeur. Plusieurs vues 
seront disponibles : 2 by 3, 4 Split, Default, Tall et Wide. 


Delete Layout.… 
Revert Factory Settings. 


Chacune des vues peut être déplacée à volonté pour créer l'espace de travail qui 
convient le mieux à vos besoins. Pour cela il suffit de sélectionner le bandeau 
contenant le nom de la vue et de le déplacer. Comme dans beaucoup d'IDE, les 
vues peuvent s'ancrer sur les bords ou s'imbriquer les unes dans les autres. Une 
fois votre environnement de travail mis en place, l'éditeur permet de le sauve- 
garder afin de pouvoir le réutiliser rapidement. 


Les menus personnalisés 


L'éditeur permet de créer ses propres menus et sous-menus afin de personna- 
liser au maximum son environnement de travail pour gagner en productivité. 
La simplicité de mise en place encourage fortement son utilisation et en géné- 
ral, il est dur de s'en passer par la suite. 
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Techniquement, la création d'un menu se fait simplement via un script qui 
sera ajouté au projet. Le principe de menu repose entièrement sur l'utilisation 
de l'attribut MenuItem. On annote la méthode avec cet attribut pour spécifier 
le nom et les propriétés de celle-ci. 


Créer un menu simple 


Afin de créer un menu, vous devez obligatoirement renseigner le nom de celui- 
ci ainsi que le nom de l’action qui lui est affectée. Dans notre exemple MyCus - 
tomMenu représente le nom du menu et Hello world le nom du sous-menu 
(ou action). 


public class CustomMenu : MonoBehaviour 


{ 


[Menultem ("MyCustomMenu/Hello world")] 
private static void SayHello() 


{ 
} 


Debug.Log ("Hello world!"); 


à Unity Personal (64bit} - Untitled - Code - PC, Mac & Linux Standatone* <DX11 on DX10 GPU> 
nu | Window _ Help 


Bye 
Hello wortd Ctri+H LL. 


3.2.2 Créer un menu avec raccourci 


Pour créer un raccourci, vous pouvez utiliser les caractères spéciaux suivants 
afin de lier une touche du clavier : 

— % : permet l'affectation de la touche [Ctri] sur Windows et [Cmd] sur OS X. 
— # : permet l'affectation de la touche [Shift]. 

— & : permet l'affectation de la touche [Alt]. 


— _: permet d'utiliser une touche seule, sans modificateur comme [Alt] ou 
[Shift]. 
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Par exemple, pour créer un menu avec raccourci-clavier [Ctrl] [Alt] S, on utili- 
sera la syntaxe suivante : "MyCustomMenu / MenuTitle % & s". 


Pour créer un menu avec raccourci "s" et sans modificateurs, on utilisera la 
syntaxe suivante : "MyCustomMenu / MenuTitle s". 


Certaines touches spéciales du clavier sont prises en charge par les raccourcis- 
clavier. Par exemple, "#LEFT" fait référence au raccourci [Shift][Flèche 
gauche]. Les clés prises en charge sont : LEFT, RIGHT, UP, DOWN, F1 … F12, 
HOME, END, PGUP, PGDN. 


public class CustomMenu : MonoBehaviour 


{ 


[Menultem ("MyCustomMenu/Hello world %h")] 
private static void SayHelloWithShortcut () 


{ 
} 


Debug.Log("Hello world!"); 


} 


Au niveau de l'affichage dans l'éditeur, on voit clairement s'afficher le raccour- 
ci à utiliser à droite du nom du menu. 


& Unity Personal (64bit} - Untitled - Code - PC, Mac & Linux Standalone* <DX11 on DX19 GPU> 
File Edit Assets GameObject Component Visual Studio Tools | 

Hello world 

Bye 


Æ Hierarchy 
_— 


HRemarque 


Un code de raccourci doit être précédé obligatoirement d'un caractère 
d'espace. À ce titre, "MyCustomMenu / MenuTitle s" ne sera pas interprété 
comme raccourci, tandis que "MyCustomMenu / MenuTitle s" le sera. 
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Créer un menu avec validation 


Le deuxième paramètre du constructeur de l'attribut MenuItem vous permet 
de définir qu'une méthode de validation sera lancée afin de valider si oui ou 
non l’action peut être effectuée (le menu devient alors grisé). Si celle-ci 
retourne vrai, l’action peut être exécutée. Dans le cas contraire, aucune autre 
action ne sera faite. 


Au niveau de la syntaxe, les deux menus doivent obligatoirement avoir le 
même nom. C'est ce qui permet de faire le lien entre les deux méthodes ! La 
fonction de validation doit aussi obligatoirement retourner un booléen. 


public class CustomMenu : MonoBehaviour 


{ 
[Menultem ("MyCustomMenu/GetObjectName")] 
private static void GetObjectName () 


{ 
} 


[Menultem ("MyCustomMenu/GetObjectName", true)] 
private static bool CanGetObjectName () 


Debug.Log(Selection.activeTransform.gameObject.name) ; 


{ 
return Selection.activeGameObject != null; 
} 
} 
Remarque 


La classe Selection permet d'accéder aux informations sur la sélection cou- 
rante dans l'éditeur, comme l'objet sélectionné dans la scène. 


Si aucun objet n'est sélectionné dans la hiérarchie, le menu sera grisé et inac- 
cessible. 


Blone* <DX11 on DX10 GPU> 


GetObiectName 
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Dans le cas contraire, le menu sera actif et cliquable. 
datone* <Dx11 on Dx19 GPU> 


Tools | MyCustomMenu | Window Help 
Hello world 


Bye 


Hello worid 
GetObjectName 


3.2.4 Créer un menu avec priorisation 


Le menu avec priorisation reprend la même structure que le précédent, c’est- 
à-dire qu’il peut avoir aussi une validation en jouant sur le deuxième para- 
mètre. 


Le troisième paramètre du constructeur vous permet de spécifier un degré de 
priorisation afin d’ordonner l'affichage de la liste. 


public class CustomMenu : MonoBehaviour 


{ 
[Menultem("MyCustomMenu/Hello world", false, 1)] 
private static void SayHelloPriorityl() 


{ 
} 


[Menultem ("MyCustomMenu/Bye", false, 3)] 
private static void SayByePriority3() 


{ 
} 


Debug.Log("Hello world!"); 


Debug.Log("Bye bye!"); 
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Créer un menu contextuel 


Pour récupérer l'information du contexte courant, il suffit de rajouter un 
paramètre à la méthode de type MenuCommand. Cette classe permet de 
connaître le contexte selon lequel la commande a été exécutée grâce à la 
propriété context. 


public class CustomMenu : MonoBehaviour 


{ 


[MenulItem("CONTEXT/Rigidbody/ResetPosition")] 
private static void ResetPosition(MenuCommand command) 


{ 
Rigidbody rigidbody = (Rigidbody)command.context ; 
rigidbody.position = Vector3.z7ero; 


} 


En général, le contexte est la sélection courante ou l'item sous la souris au 
moment de l'ouverture du menu contextuel. Dans notre exemple, on 
remarque que le nom du menu est composé du texte CONTEXT, suivi de 
Rigidbody puis du nom du sous-menu voulu ResetPosition. Avoir 
rajouté Rigidbody va limiter l’utilisation au composant Rigidbody. Le 
menu n'apparaîtra pas sur les autres types de composants. 


Reset 


Remove Component 
Move Un 

Move Down 

Copy Component 


Paste Component Às Mew 


Paste Component Values 


79 


80 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


3.2.6 Modifier ies menus de base de l'éditeur 


Il est possible d'ajouter une nouvelle entrée dans les menus standards de 
l'éditeur telle que GameObiject, Assets.. Cela se fait exactement de la même 
manière que précédemment, il suffit de bien respecter les noms des menus 
existants. 


Création d'un nouveau GameObject : 


public class CustomMenu : MonoBehaviour 
{ 
[Menultem ("GameObject/MyCustomMenu/Custom Game Object")] 
static void CreateCustomGameObject (MenuCommand menuCommand) 
{ 
// Création d'un nouveau GameObject 
GameObject go = new GameObject ("Custom Game Object"); 


// Renseigne le parent de l'objet dans le cas d'une 
// création contextuelle via la panneau hiérarchie par exemple 
GameObjectUtility.SetParentAndAlign(go, 

menuCommand.context as GameObject) ; 


// Enregistrement de la création dans le système 
// d'annulation afin de pouvoir revenir en arrière ultérieurement 
Undo.RegisterCreatedObjectUndo(go, "Create " + go.name); 


// Sélectionne l'objet créé dans la hiérarchie 
Selection.activeObject = go; 
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64bit} - Untitled - Code - PC, Mac & Linux Standalone* <DX11 on DX10 GPU> 


Create Empty Ctri+Shift+N 
Create Empty Child Alt+Shift+N 
3D Object 

2D Object 

Light 

Audio 

UI 

Particle System 

Camera 


Center On Children 


Make Parent 

Clear Parent 

Apply Changes Ta Prefab 
Break Prefab Instance 


Set as first sibling Ctrir= 
Set as lact cibling Ctrl+- 
Move To View Ctri+Alt+F 


Align With View Ctri+Shift+F 
Align View to Selected 


Toggle Active State Alt+Shift+ A 
ke 


3.3 Personnaliser la scène 


3.3.1 Introduction 


Toujours dans le cadre de la personnalisation de l'éditeur, il est possible d'ajou- 
ter des éléments visuels, qui ne seront pas affichés hors de l'éditeur, dans la vue 
Scene à des fins de prototypage ou de tests : c'est ce que l'on appelle des 
gizmos. 
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Afin d'afficher des gizmos, il existe deux fonctions pouvant être utilisées dans 
un script personnalisé : 


using UnityEngine; 


public class MyGizmoBehaviour : MonoBehaviour 


void OnDrawGizmos () 
{ 
// Les gizmos créés dans cette méthode seront 
// systématiquement affichés 
} 
void OnDrawGizmosSelected() 
// Les gizmos créés dans cette méthode seront affichés 
// uniquement lorsque l'objet est sélectionné 
} 
} 


3.3.2 Utilisation des gizmos 


Afin d'illustrer la manipulation des gizmos, nous allons créer un script person- 
nalisé qui aura comme unique tâche d'afficher le repère inversé d'un objet. Le 
code utilisera les méthodes statiques DrawSphere et DrawLine de la classe 
Gizmos : 


using UnityEngine; 


public class MyGizmoBehaviour : MonoBehaviour 


private Vector3 positionx; 
private Vector3 positionY; 
private Vector3 positionz; 


private float offset; 


void OnDrawGizmos () 


{ 


// Modification de la couleur des gizmos en bleu 
Gizmos.color = Color.blue; 
_offset = 0.2f; 


// Positionnement du centre des sphères pour les 3 axes 
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_positionX = new Vector3(-(transform.localPosition.x + 
(transform.localScale.x / 2) + offset), 
transform.localPosition.y, transform.localPosition.z); 

_positionY = new Vector3 (transform.localPosition.x, - 
(transform.localPosition.y + (transform.localScale.y / 2) + 
_offset), transform.localPosition.z); 

_positionZ = new Vector3 (transform.localPosition.x, 
transform.localPosition.y, -(transform.localPosition.z + 
(transform.localScale.z / 2) + offset)); 


// Affichage des sphères 

Gizmos.DrawSphere(_positionX, transform.localScale.x / 10); 
Gizmos.DrawSphere(_positionYÿ, transform.localScale.y / 10); 
Gizmos.DrawSphere( _positionZ, transform.localScale.z / 10); 


// Affichage des lignes 

Gizmos.DrawLine (transform.localPosition, positionX); 
Gizmos .DrawLine (transform.localPosition, positionY); 
Gizmos.DrawLine (transform.localPosition, positionZ); 


} 


Ce qui donne le résultat suivant dans la vue Scene lorsque le script est rattaché 
à un objet en le faisant glisser dans la fenêtre Inspector : 
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3.4 Personnaliser l'Inspector 


3.4.1 Introduction 


Comme on l'a vu précédemment, l'Inspector est un outil extrêmement puissant 
et il est très utilisé lors de la mise en place d'une scène. Bien qu'il réponde à la 
plupart des besoins classiques (gestion des nombres, zone de texte, sliders….), le 
besoin de le personnaliser peut se faire sentir afin d'avoir un affichage clair des 
données et pouvoir les manipuler plus facilement. 


Pour illustrer nos propos, nous allons nous appuyer sur différents exemples 
qui mettront en scène des cas possibles de personnalisation. 


3.4.2 Mise en place d'un affichage personnalisé 


Commençons tout d'abord par créer un script qui illustrera le nombre de 
points d'expérience acquis par un joueur. Le calcul se basera sur le nombre de 
vies restantes et le nombre d'ennemis tués. 


using UnityEngine; 
public class MySimpleltem : MonoBehaviour 
{ 

public int XpPerEnemyKilled; 


public int EnemiesKilled; 


public int Experience 


{ 
} 


get { return XpPerEnemyKilled * EnemiesKilled; } 


} 


On ajoute ensuite un nouveau GameObiject dans la scène en lui associant le 
script créé précédemment. On s'aperçoit que la propriété Experience n'est 
pas du tout affichée dans l'Inspector alors que XpPerEnemyKilled et 
EnemiesKilled le sont bien. 


© Editions ENI - AIl rights reserved 


85 


Éditeur, pièce maîtresse 
Chapitre 2 


Si l'on veut voir cette information dans le panneau de l'Inspector, il faut créer 
un autre script qui assurera l'affichage des données de cette classe. Cela se fait 
en plaçant l'attribut CustomEditor sur une nouvelle classe dérivant de la 
classe Editor. 


using UnityEditor; 


[CustomEditor (typeof (MySimpleltem))] 
public class MySimpleltemEditor : Editor 
{ , 

public override void OnlnspectorGUI () 


{ 


MySimpleltem myTarget = (MySimpleltem) target; 


myTarget.XpPerEnemyKilled = EditorGUILayout.IntField("Xxp 
Per Enemy Killed'", myTarget.XpPerEnemyKilled) ; 

myTarget.EnemiesKilled = EditorGUILayout.IntField("Enemies 
Killed'", myTarget .EnemiesKilled) ; 

EditorGUILayout.LabelField("Experience", string.Format ("{0} 
xp", myTarget .Experience) ); 


} 


On utilise la classe EditorGUILayout afin de créer des champs de saisie de 
différents types. Dans notre exemple, la méthode IntField permet d’ajou- 
ter un champ de type entier et LabelField pour ajouter du texte non modi- 
fiable. La construction est généralement la même avec comme premier 
paramètre le nom du champ et en second la valeur de celui-ci. 
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3.4.3 Ajouter un bouton 


Dans cet exemple, nous allons voir comment ajouter des boutons dans la vue 
de notre composant dans l'Inspector. En partant des scripts précédents, nous 
ajouterons deux boutons qui permettront d'augmenter ou de diminuer le 
nombre d'expériences acquises lorsqu'un ennemi est tué. 


HRemarque 


Dans l'exemple précédent, nous avons vu que pour personnaliser l'affichage, 
il fallait surcharger la méthode onInspectorGUI et ajouter manuellement les 
propriétés que l'on voulait voir s'afficher. Sachez qu'il existe une méthode 
DrawDefault Inspector qui permet d'ajouter automatiquement l'ensemble 
des champs en fonction du type de variable, comme le fait l'éditeur par 
défaut. 


L'ajout d'un bouton se fait grâce à la classe GUILayout qui permet de créer 
des éléments d'interface utilisateur avec une mise en forme automatique. Il est 
bien entendu possible de les personnaliser mais ce n'est pas le but de cet 
exemple, nous resterons donc sur la création d'un bouton simple. 


using UnityEditor; 
using UnityEngine; 


[CustomEditor (typeof (MySimpleltem))] 
public class MySimpleltemEditor : Editor 


{ 


public override void OnInspectorGUI () 


{ 
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// Affichage des propriétés par défaut 
DrawDefaultInspector () ; 


MySimpleltem myTarget = (MySimpleltem) target; 
EditorGUILayout.LabelField("Experience", string.Format("{0} xp", 
myTarget .Experience) ) ; 


// Ouvre un groupe horizontal pour accueillir les deux boutons 
EditorGUILayout.BeginHorizontal (); 


// Diminue de 10 l'expérience acquise 
if (GUILayout.Button("- 10")) 


{ 


myTarget.XpPerEnemyKilled -= 10; 


// Si le resultat devient négatif, on le force à zéro 
if (myTarget.xXpPerEnemyKilled < 0) 


{ 
} 


myTarget.XpPerEnemyKilled = 0; 


} 


// Augmente de 10 l'expérience acquise 
if (GUILayout.Button("+ 10")) 


{ 
} 


myTarget.XpPerEnemyKilled += 10; 


// Ferme le groupe horizontal 
EditorGUILayout.EndHorizontal (); 


BRemarque 


On utilise la classe EditorGUILayout et les fonctions BeginHorizontal et 
EndHorizontal pour créer un groupe de contrôle horizontal afin d'héberger 
les deux boutons. Le résultat nous montre les boutons côte à côte. Sans l'utili- 
sation de ces deux méthodes, les boutons seraient rendus l'un au-dessus de 
l'autre. Il existe plusieurs tyoes de mise en forme dans la classe EditorGUI- 
Layout, n'hésitez pas à les utiliser pour rendre l'interface plus pratique. 
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Ajouter une zone d'aide 


Il peut aussi être intéressant d'informer l'utilisateur dans des cas particuliers. 
Pour cela, il existe la méthode HelpBox dans la classe EditorGUILayout 
qui va permettre de créer une zone comprenant un texte et une image définis- 
sant le caractère de celui-ci (erreur, informatif, avertissement...). 


Dans notre exemple, nous aimerions afficher le niveau du joueur par rapport 
à l'expérience qu'il a acquise, sachant que 150 points d'expérience correspon- 
dent à un niveau. Si l'expérience gagnée ou le nombre d'ennemis tués devien- 
nent négatifs, nous afficherons un message d'erreur. 


using UnityEditor; 
using UnityEngine; 


[CustomEditor (typeof (MySimpleltem))] 
public class MySimpleltemEditor : Editor 


{ 


public override void OnInspectorGUI () 

{ 
// Affichage des propriétés par défaut 
DrawDefaultInspector () ; 


MySimpleltem myTarget = (MySimpleltem) target ; 
EditorGUILayout.LabelField("Experience", string.Format("{0} xp", 
myTarget .Experience) ); 
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// Ouvre un groupe horizontal pour accueillir les deux boutons 
EditorGUILayout .BeginHorizontal (); 


// Diminue de 10 l'expérience aquise 
if (GUILayout.Button("- 10")) 


{ 
} 


myTarget .XpPerEnemyKilled -= 10; 


// Augmente de 10 l'expérience aquise 
if (GUILayout.Button("+ 10")) 


{ 
} 


myTarget.XpPerEnemyKilled += 10; 


// Ferme le groupe horizontal 
EditorGUILayout .EndHorizontal (); 


// Si le résultat devient négatif, on affiche un message d'erreur 
if (myTarget .EnemiesKilled < 0) 
{ 
EditorGUILayout .HelpBox ("Le nombre d'ennemis tués ne peut 
pas être négatif !", MessageType.Error) ; 


} 


// Si le résultat devient négatif, on affiche un message d'erreur 
if (myTarget .XpPerEnemyKilled < 0) 
{ 
EditorGUILayout .HelpBox ("L'expérience gagnée ne peut pas être 
négative !", MessageType.Error); 


} 


// Affichage du niveau 

int level = myTarget.Experience / 150; 

EditorGUILayout .HelpBox(string.Format ("Le joueur est 
au niveau {0}", level), MessageType. Info) ; 
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3.4.5 Les différents types de champs 


Dans les exemples précédents nous avons utilisé que quelques types de 
champs mais il en existe beaucoup d'autres. Voici une partie de ces champs 
utilisés dans un script et le résultat dans l'éditeur d'Unity : 


using UnityEngine; 
using UnityEditor; 


[CustomEditor (typeof (AllFiledsItem))] 
public class AllFiledsEditor : Editor 
{ 
public override void OninspectorGUI () 
{ 
EditorGUILayout.IntField("Int", 40); 
EditorGUILayout.DoubleField("Double", 100); 
EditorGUILayout.LongField("Long", 1234567890123456789) ; 
EditorGUILayout.FloatField("Float", 100.45f); 


EditorGUILayout.ColorField("Color", new Color()); 
EditorGUILayout.CurveField("Curve", new AnimationCurve ()); 
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EditorGUILayout.TextField("Text", "L'éditeur est vraiment 
très pratique !"); 
EditorGUILayout.PasswordField("Password", "unity3d"); 
EditorGUILayout.LabelField("Label", "Un texte neutre"); 


EditorGUILayout.LayerField("Layer", 1); 
EditorGUILayout.TagField("Tag", "Player"); 


EditorGUILayout.MaskField("Mask", 1, new[] { "Mask1", "Mask2" }); 
EditorGUILayout .EnumMaskField("Enum Mask", MessageType.Info); 


EditorGUILayout.RectField("Rect", new Rect(3, 2, O0, 1)); 
EditorGUILayout.BoundsField("Bounds", new Bounds (Vector3.zero, 
Vector3.one) ); 


EditorGUILayout .Vector2Field("Vector2", new Vector2(40, 22.4f)); 

EditorGUILayout.Vector2Field("Vector3", new Vector3(1, 2, -3)); 

EditorGUILayout.Vector2Field("Vector4", new Vector4(22, O.4f, 
-123, O)); 


} 


Parmi tous ces champs, on retrouve quelques grandes catégories comme les 
nombres (entiers, à virgule) avec les méthodes IntField ou bien Float- 
Field, les textes avec les méthodes TextField ou LabelField, ainsi que 
les vecteurs avec Vector2Field ou Vector3Field. Les autres champs, 
comme la couleur avec la méthode ColorField, sont très spécifiques. 


A 
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_ 3.4.6 Aller plus loin 


Grâce aux classes EditorGUI et EditorGUILayout, nous avons toutes les 
cartes en main pour créer l'affichage parfait pour représenter nos classes et 
objets dans l'Inspector. Ce livre n'ayant pas vocation à être exhaustif, nous 
n'avons pas passé en revue l'intégralité des possibilités d'affichage, seulement 
les grands principes. 
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Plusieurs méthodes non abordées dans ce chapitre peuvent être utiles et sont 
très simples d'utilisation : 


— EditorGUILayout .Space : permet d'ajouter un espacement entre deux 
éléments. 


— EditorGUILayout.BeginScrollView et EditorGUI- 
Layout .EndScrollView : permettent de créer une barre de défilement 
pouvant accueillir d'autres éléments de rendu. 


— EditorGUILayout .BeginFadeGroup et EditorGUILayout.End- 
FadeGroup : permettent de créer un groupe pouvant être affiché ou 
masqué en utilisant une transition. 


Nous n'avons pas traité le style d'affichage de nos éléments, mais sachez qu'il 
est possible de créer des styles personnalisés sur la plupart des éléments par le 
biais de la classe GUIStyle. 
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1. La programmation par composition 


1.1 Présentation 


Un concept fondamental à comprendre lorsque l'on veut se lancer dans la 
création de script personnalisé ou plus simplement dans la manipulation d'un 
objet, comme l'ajout d'une texture particulière, est le principe de programma- 
tion par composition. 


L'idée étant de partir d'une boîte vide qui sera la pièce principale utilisée par 
l'ensemble des entités pour ensuite lui ajouter des composants. Cette entité en 
est réduite à être un simple conteneur de composant. La combinaison des 
composants crée ainsi une entité spécifique simple ou complexe. 


Un composant peut ainsi se traduire comme un comportement qui est ajouté 
à une entité "conteneur". Cette même entité est alors définie par les différents 
composants qui la composent. Les composants sont par contre liés à un seul 


objet "conteneur" parent et leur durée de vie est intimement liée à celui-ci. 
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Composant / comportement 3 


Composant / comportement 4 


Composant / comportement 2 Composant / comportement 4 


Composant / comportement 4 


Objet « conteneur » 


On peut ainsi considérer cet exemple du monde réel : l'entité "Vélo" est 
composée de deux composants "roues", d'un composant "guidon" et d'un com- 
posant "selle". 


Attention, vous pouvez aussi entendre parler de programmation par agréga- 
tion, qui est un concept très proche de la programmation par composition. 


Le GameObject : le conteneur de composants 


Unity s'appuie entièrement sur ce design pattern (patron de conception) afin 
de créer tout type d'objets : personnage animé, carte de monde, caméra, etc. 


L'objet de base servant de conteneur est la classe GameObject. Comme vu 
dans le chapitre précédent, une scène consiste notamment en une hiérarchie 
de GameObjects ayant un ou plusieurs composants rattachés. 


Chacun de ces composants peut ainsi être ajouté une ou plusieurs fois au 
même GameObject. 
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Les différentes familles de composants 


Il existe une multitude de types de composants faisant directement partie 
d'Unity. Pour tous les autres cas, il est possible de créer des scripts personna- 
lisés pour répondre à des besoins spécifiques. 


Les composants de base sont regroupés dans de grandes familles en fonction 
de leurs spécificités dans Unity. En voici une liste des principales. 


Les meshes 


Un mesh (maille) représente une structure composée de sommets et d'arêtes 
permettant de définir une forme géométrique simple. Cette structure peut 
être un triangle, un quadrilatère ou un polygone convexe. Lorsque plusieurs 
mailles de même type sont assemblées, on appelle cela un maillage. Ce 
maillage de type fil de fer représente un objet tridimensionnel et permet, grâce 
à des formes simples, de recréer des formes complexes comme une voiture ou 
un visage. 


Dans un moteur 3D, les meshes sont utilisés afin de rendre à l'écran une forme 
8D sur un plan 2D (l'écran) via un procédé de rastérisation. Cette technique 
permet de convertir une forme vectorielle en une forme matricielle (constituée 
de pixels). 


Le choix de la géométrie d'une maille et du nombre de mailles utilisées pour 
représenter un objet repose en partie sur le rapport entre la qualité de rendu 
visuel et le temps de traitement. En effet, plus grand est le nombre de mailles, 
plus les calculs deviennent importants. De même, plus la forme de la maille 
est primitive, plus les calculs sont simples. 


L'utilisation de mailles se fait à travers deux types de composants : Filter et 
Renderer. Le premier sert à définir le mesh à utiliser via le composant Mesh- 
Filter ou TextMesh, le deuxième sert à définir le rendu à lui appliquer en 
associant un matériau grâce aux composants MeshRenderer où Skinned- 
MeshRenderer. Pour imager, le composant Filter correspond à la structure 
d’un objet ressemblant à la tour Eiffel ou à un pylone électrique, alors que le 
composant Renderer correspond à la peinture de la façade d’un bâtiment. 
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Les effets 


Unity propose différents types d'effets pouvant s'appliquer sur des GameOb- 
jects ou s'utiliser indépendamment. L'un des plus connus est sûrement le sys- 
tème de gestion des particules qui permet, à partir d'images 2D ou de meshes, 
de recréer un effet de flamme, d'explosion, de jet d'eau. 


Il existe aussi d'autres effets afin de créer un halo lumineux (Halo) ou bien de 
reproduire une traînée (LineRenderer et TrailRenderer). 


La physique 3D 


Cette famille regroupe l'ensemble des composants liés à la physique tridimen- 
sionnelle du jeu. Le moteur physique de Unity est chargé d'exploiter ces 
données afin de modifier le comportement des objets en adéquation avec la 
physique prévue dans le jeu (gravité, force, collision….). 


Pour ce faire, trois grandes catégories de composants existent afin de définir le 
comportement de chaque GameObiject de la scène et comment il doit réagir. 
Premièrement, on trouve le Rigidboby qui permet de définir les 
caractéristiques physiques de base d'un objet comme sa masse, s'il doit être ou 
non affecté par la gravité, etc. Ensuite vient toute une série de composants qui 
entrent en compte lorsque l'on travaille avec les collisions : c'est ce qu'on appelle 
des colliders. Les types se rapportant au collider dépendent principalement de la 
forme géométrique de l'objet auquel il se réfère. On peut donc utiliser le 
BoxCollider, le SphereCollider, le CapsuleCollider, le 
MeshCollider, le WheelCollider et le TerrainCollider. La dernière 
catégorie est utilisée afin de créer une liaison entre des objets. Ces liaisons 
permettent, par exemple, de lier la main d'un personnage à son avant-bras en 
définissant les axes de rotations possibles ainsi que leurs limites. Les différents 
types de jonction possibles sont le HingeJoint, le FixedJoint, le 
SpringJoint, le CharacterJoint et le ConfiqurableJoint. 


Remarque 


D'autres composants plus spécifiques sont disponibles comme le Cloth qui 
s'utilise en complément d'un SkinnedMeshRenderer afin de spécifier le com- 
portement d'un vêtement pour un personnage. Le composant Constant- 
Force permet, quant à lui de définir une force constante à Un Rigidbody, 
très pratique pour la gestion des projectiles par exemple. 
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La physique 2D 


La plupart des composants ayant trait à la physique 8D retrouvent leurs 
équivalents pour la physique 2D. Le Rigidbody deviendra le Rigidbody2D, 
le SphereCollider sera remplacé par le CircleCollider2D, le 
SpringJoint par le SpringJoint2D, etc. 


Les nouveautés résident dans les composants permettant de créer des forces 
de contact, appelés Effector. Le principe de fonctionnement est simple : 
l'Effector applique une force lorsqu'un objet entre en collision avec sa zone 
d'effet. Plusieurs types de contact sont possibles comme le 
PointEffector2D, l'AreaEffector2D, le SurfaceEffector2D et le 
PlatformEffector2D. 


La navigation 


Faire avancer un personnage dans une scène vers un objectif précis en prenant 
en compte les obstacles et les autres personnages de celle-ci peut s'avérer être 
une tâche complexe. Heureusement, les composants NavMeshAgent, 
NavMeshObstacle et Off-MeshLink permettent de gérer cette contrainte. 


L'audio 


Les sons font partie intégrante de la création d'un jeu vidéo et Unity l'a bien 
compris en mettant à disposition des composants facilitant l'utilisation de 
ceux-ci. Les deux principaux sont l'AudioSource et l'AudioListener. Le 
premier, utilisé pour jouer un son dans la scène, est défini via un AudioClip. 
Le deuxième se comporte comme un micro qui enregistre tous les sons d'une 
scène à partir de son point d'ancrage (en général la caméra) pour les restituer 
ensuite au joueur. 


Les autres types de composants sont des filtres audio qui permettent de modi- 
fier les sorties de l'AudioSource et de l'AudioListener. Les différents 
filtres applicables sont l'AudioLowPassFilter, l'AudioHighPassFil- 
ter, l'AudioEchoFilter, l'AudioDistortionFilter, l'AudioRever- 
bFilteret l'AudioChorusFilter. 
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Remarque 


Il est possible de créer des zones de réverbération afin de rendre réalistes les 
sons dans une pièce fermée (grotte, couloir étroit...) Pour cela, on utilisera le 
composant Reverb Zone. 


1.3.7 Le rendu 


Unity propose une large palette de composants ayant pour vocation de modi- 
fier l'affichage de la scène, grâce à une lumière, ou plus simplement d'afficher 
un élément, comme une image. 


Le composant Camera est utilisé afin d'afficher le monde virtuel au joueur. Il 
est possible d'ajouter autant de caméras qu'on le souhaite afin de rendre 
visibles différents points de vue en même temps ou de changer rapidement 
d'angle de vue. Il est possible d'ajouter une Skybox à une scène afin de définir 
le rendu à afficher au-delà des limites du monde. Cela correspond le plus sou- 
vent en un ciel virtuel. Indépendamment de ces composants, le FlareLayer 
et le GUILayer sont des couches de rendu permettant l'affichage, pour le pre- 
mier, des effets visuels de la lumière qui se réfléchit dans la lentille de la camé- 
ra. Pour le second, il sert de base de rendu pour l'affichage de l'interface en 2D. 
Ces deux composants sont obligatoirement rattachés à une caméra. 


Remarque 


Dans chaque nouvelle scène, un GameObject ayant les composants Camera, 
Flare Layer, GUILayer et AudioListener est ajouté automatiquement. 


Pour ajouter de la lumière dans une scène, le composant Light est tout indi- 
qué. Il permet de créer différents types de lumière (spot, directionnelle, aire.) 
afin de donner une ambiance spécifique à votre jeu. D'autres composants plus 
complexes tels que le ReflectionProbe et le LightProbeGroup fournis- 
sent des outils pour mettre en place de la réflexion ou un groupement de 
lumière au sein d'une scène. 


Un autre groupe de composants traite de la visibilité des objets de la scène 
pour traiter deux problématiques. La première s'appelle l'occlusion et 
permet, par exemple, de dissimuler les objets en dehors du champ de la 
caméra. La seconde traite de la qualité d'affichage des objets en fonction de 
la distance du point de vue ; on appelle cela le LOD (Level Of Detail). 
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Le principe est simple, différents niveaux de détail sont définis par rapport 
à la distance de la caméra. Pour chaque niveau, on applique un maillage 
différent. 


1.3.8 La disposition de l'interface utilisateur 


Cette famille regroupe l'ensemble des composants utilisés pour gérer la dispo- 
sition des éléments de l'interface utilisateur. On retrouve, par exemple, le 
composant RectTransform, qui est associé automatiquement sur chaque 
composant de l'interface, et qui permet de définir sa position et sa taille sur sa 
zone de rendu 2D. Autre composant très important, le Canvas est l'élément 
parent de toute interface graphique. Il est obligatoire et tous les éléments 
graphiques sont nécessairement à l'intérieur d'un Canvas. 


Pour en savoir plus sur l'interface utilisateur, rendez-vous au chapitre Unity 
UT et interfaces utilisateurs. 


1.3.9 L'interface utilisateur 


Fortement liés au groupe précédent car définissant l'interface utilisateur, les 
composants de celui-ci sont de type Text, Image ou encore Button. Une 
fois la disposition de votre interface définie, ces composants seront utiles pour 
modeler selon vos envies les interactions de l'utilisateur. 


Pour en savoir plus sur l'interface utilisateur, rendez-vous au chapitre Unity 
UT et interfaces utilisateurs. 


1.3.10 Les scripts 


Unity permet aux utilisateurs de créer des scripts personnalisés afin de définir 
un comportement spécifique. L'ensemble de ces scripts sont répertoriés dans 
cette famille. 


1.3.11 Le réseau 


Créer des jeux multijoueurs est tout à fait possible et l'arrivée de la version 5 
de l'éditeur nous facilite grandement la tâche. Les composants NetworkMa - 
nager ou NetworkIdentity sont là pour créer et paramétrer facilement un 
jeu en réseau. 
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1.3.12 Les événements 


Plusieurs composants permettent d'envoyer des événements à des objets à 
partir d'une action au clavier, à la souris, au toucher ou par toute autre action 
personnalisée. On a par exemple le composant TouchInputModule qui sert 
à envoyer des événements de toucher en réponse d'une entrée utilisateur 
(PointerEnter, PointerPress, PointerExit, BeginDrag, EndDrag, 
etc.). 


1.3.13 Les autres 


Tous les scripts qui ne rentrent dans aucune des autres familles se retrouvent 


‘ dans ce groupe. On retrouve par exemple les composants Animation et 


2.1 


2.2 


2.2.1 


Animator utilisés pour animer des objets dans la scène. 


La classe GameObject 


Présentation 


La classe GameObject est, comme nous venons de le voir, la classe de base, 
fondamentale, pour l'ensemble des objets disposés dans une scène. Un 
GameObiject seul est très peu utile car ses fonctions sont très basiques : affec- 
tation d'un nom, d'un tag ou d'un layer spécifique. 


Si cet objet semble à première vue complètement inutile, sa grande force est 
de pouvoir se rendre modulaire très facilement grâce à l'ajout de composant. 


Manipuler un GameObject 


Ajouter un GameObject 


Une des manipulations que vous ferez certainement le plus souvent sera 
d'ajouter un nouveau GameObject dans une scène. Cela peut se faire très sim- 
plement. 
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Création d’un GameObiject vide 


Dans la fenêtre Hierarchy, sélectionnez Create - Create Empty. 


Create Empty 
Create Empty Child 
3D Object 

2D Object 


Light 

Audio 

UI 

Particle System 
Camera 


Le nom de l'objet est utilisé afin de pouvoir récupérer l'élément via un script 
et pour l'identifier dans la hiérarchie. 


À ce titre, il est intéressant de normaliser le nom de vos objets dans la 
hiérarchie afin de vous simplifier la vie. Une scène peut facilement passer les 
centaines d'objets et cela peut vite devenir une horreur pour trouver un 
élément précis. 
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2.2.2 Supprimer un GameObject 


3.1 


S'il est possible d'ajouter un nombre illimité d'objets dans la scène, il est aussi 
possible de les supprimer tout aussi facilement. 


Dans la fenêtre Hierarchy, sélectionnez le ou les objets à supprimer et 
appuyer sur la touche [Suppr] du clavier. 


Manipuler les composants dans l'éditeur 


Une fois un GameObject ajouté à la scène, il est possible de lui ajouter des 
composants. 


Remarque 


Nous verrons aussi dans le chapitre suivant qu'il est possible de manipuler les 
composants via un script. 


Ajouter un composant 


Il est très simple de manipuler un objet d'une scène pour lui ajouter, supprimer 
ou modifier un composant. La fenêtre Inspector permet d'afficher la liste des 
composants ainsi que l'accès aux propriétés de ceux-ci. 


Création d'une sphère 


Dans la fenêtre Hierarchy, sélectionnez Create - Create Empty. 


© Editions ENI - AI rights reserved 


105 


Le GameObject et ses composants 
Chapitre 3 


Dans la fenêtre Inspector, cliquez sur Add Component - Mesh - Mesh 
Filter. 


Un nouveau composant Mesh apparaît dans l’Inspector. 


Dans la fenêtre Inspector - Mesh Filter, cliquez sur l'outil de sélection E 
à droite du champ de saisie Mesh. 
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Dans la liste, double cliquez sur Sphere. 


Dans la fenêtre Inspector, cliquez sur Add Component - Mesh - Mesh 
Renderer. 
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Dans la fenêtre Inspector - Mesh Renderer - Materials, cliquez sur 


l'outil de sélection ÆE à droite du champ de saisie Element 0 puis double 
cliquez sur Default-Material. 


Select Material 
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Celui-ci apparaît dans l’Inspector : 


Hierarchy Ë 


Dans la fenêtre Inspector, cliquez sur Add Component - Physics - 
Sphere Collider. 


Hierarchy D © Inspector 


Remarque 


L'éditeur propose aussi des objets de base tels que le cube, la caméra, la 
lumière directionnelle.. De ce fait, la sphère précédemment créée peut se 
fabriquer en seulement quelques clics à partir de la fenêtre Hierarchy - Create - 
3D Object - Sphere. 
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Supprimer un composant 


Il est possible d'enlever n'importe quel composant d'un GameObject. 


Dans la fenêtre Hierarchy, sélectionnez la sphère créée dans la section 
précédente. 


Dans la fenêtre Inspector - Sphere Collider, sélectionnez l'icône d'option 


en haut à droite puis cliquez sur Remove Component. 


Li Inspector 


Copier un composant 


Les composants peuvent être transmis d'un objet à un autre par le biais d'une 
opération de copie. Lors de cette opération, les paramètres du composant à 
copier seront automatiquement transmis au nouveau composant. 


Dans la fenêtre Hierarchy, sélectionnez la sphère créée précédemment et 
nommée GameObject. 


Dans la fenêtre Inspector - Mesh Renderer, sélectionnez l'icône d'option 


en haut à droite puis cliquez sur Copy Component. 


Dans la fenêtre Hierarchy, sélectionnez Create - Create Empty. 
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Dans la fenêtre Inspector - Transform du nouvel objet créé, sélectionnez 


l'icône d'option 
New. 


en haut à droite puis cliquez sur Paste Component As 


S inspector 


3.4 Mise à zéro d'un composant 


Dans certains cas, il peut être utile de pouvoir remettre à zéro l'intégralité d'un 
composant. En utilisant cette fonctionnalité, l'intégralité des propriétés du 
composant seront réinitialisées à leurs valeurs par défaut. 


Dans la fenêtre Hierarchy, sélectionnez la sphère nommée GameObject 
(1). 


Dans la fenêtre Inspector - Transform, modifiez la Position sur l'axe X à 
100. 


CL . Cameobna Gi) | Cistatic » 


Layer 
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Dans la fenêtre Inspector - Transform, sélectionnez l'icône d'option 
en haut à droite puis cliquez sur Reset. 


4. Réutiliser ses objets grâce aux préfabriqués 


4.1 Présentation 


Lors de la création d'une scène dans l'éditeur, de multiples GameObjects sont 
créés avec leurs composants propres et leurs valeurs bien définies. Très 
souvent, un objet peut être dupliqué un grand nombre de fois, lors de la créa- 
tion d'un décor par exemple, et cela peut être fastidieux de modifier chaque 
GameObiject, un par un, afin de modifier une valeur. 


C'est à ce moment que les objets préfabriqués, appelés prefabs, viennent à 
notre secours. Ils permettent d'enregistrer des objets avec l'ensemble de leurs 
composants ainsi que leurs valeurs pour être réutilisés. En utilisant un prefab 
dans une scène, vous vous assurez que l'ensemble de ses instances seront iden- 
tiques en tout point à la création. Il est aussi tout à fait possible de modifier 
unitairement chaque instance du prefab lorsqu'il est dans la scène. 


4.2 Création d'un prefab 
La création d'un prefab dans l'éditeur se fait à partir d'une simple opération de 
glisser/déposer. 


Créez une nouvelle scène et ajoutez-lui deux sphères grâce au menu Create - 
3D Object - Sphere de la fenêtre Hierarchy. 
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= Hierarchy 


Create Empty 
Create Empty Child 


Capsule Light 

Cylinder Audio 

Plane ul 

Quad Particle System 
Ragdoll…. Camera 
Terrain 

Tree 

Wind Zone 

3D Text 


Ajoutez un GameObject vide et nommez-le MyPrefab. Sélectionnez les deux 
sphères précédemment créées dans la fenêtre Hierarchy et déplacez-les sur 
l'objet MyPrefab, qui devient le parent. 


DPlacez les deux sphères côte à côte de façon à ce qu'elles se touchent presque. 


# Scene 
Shaded 
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Sélectionnez l'objet MyPrefab et faites-le glisser dans la fenêtre Project dans 
le dossier de votre choix. Le prefab est créé ! 


HRemarque 


Une fois le prefab créé, celui-ci change de couleur dans la hiérarchie des 
objets de la scène (par défaut sa couleur devient bleue) afin de pouvoir 
l'identifier plus facilement. 


4.3 Réutilisation d'un prefab 


Comme un objet préfabriqué ne sert à rien s'il n'est pas réutilisé, nous allons 
voir la procédure à suivre afin de l'ajouter à une scène. 


4.3.1 À partir de l'éditeur 


Rappelez-vous, lors de la création, la seule manipulation requise pour créer le 
prefab a été de le glisser/déposer dans la fenêtre Project. Pour l'intégrer dans 
la scène, on utilise la manipulation inverse : on glisse et dépose le prefab de la 
fenêtre Project vers notre scène. Cette opération peut se faire un nombre illi- 
mité de fois. 


4.3.2 À partir d'un script 


Niveau scripting, nous allons utiliser la méthode Instanciate, héritée de la 
classe Object. Elle a le même rôle que la fonction Duplicate dans l'éditeur, 
qui permet de cloner entièrement un GameObject ou un composant ainsi que 
l'intégralité de ses objets fils et leurs propriétés. 
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Remarque 


La duplication d'un composant copie également l'objet parent auquel il est 
associé. 


La méthode prend en paramètre le GameObject ou le composant à cloner et, 
optionnellement, sa position et son orientation dans la scène. 


Cela peut se traduire par le script suivant qui permet de créer 10 instances d'un 
même prefab qui sera lié au script à partir de l'éditeur. 


using UnityEngine; 


public class AddPrefabOnStart : MonoBehaviour 


{ 


// Référence vers le prefab à utiliser 
public Transform MyPrefabLink; 


void Start () 


{ 


// On crée 10 instances du prefab 
for (int x = 0; x < 10; x++) 


{ 


Instantiate (MyPrefabLink, new Vector3(x + (0.5f * 
X), 0, 0), Quaternion.identity); 


} 


L'association du prefab MyPrefab à utiliser dans le script se fait, encore une 
fois, en glissant et déposant l'objet dans la fenêtre de l'Inspector au niveau de 
la propriété My Prefab Link. 
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4.3.3 Modification d'un prefab 


Une fois le prefab instancié dans la scène, il est possible de le modifier indé- 
pendamment dans l'Inspector afin de modifier son comportement, où à partir 
d'un script. Si, une fois les modifications terminées, vous décidez que votre 
prefab doit conserver ses changements afin qu'ils soient répercutés pour 
toutes les instances de la scène, il faut utiliser le bouton Apply présent dans 
la fenêtre de l'Inspector. 


Lors de la modification d'une valeur d'un composant d'un prefab, la propriété 
s'affiche en gras afin de voir plus facilement les changements apportés à 
l'objet. Le bouton Revert permet d'annuler les modifications en cours pour 
revenir à l'état de départ du prefab. 


Le bouton Select sert quant à lui à retrouver Le prefab dans la fenêtre Project, 
ce qui peut être très utile dans un gros projet ou si plusieurs prefabs portent le 
même nom. 


Chapitre 4 
Le système de scripting 


1. Les scripts, des composants à part 


1.1 Définition 


Nous avons vu dans le chapitre précédent qu'Unity repose sur le principe de la 
programmation par composition. Les scripts sont les composants permettant 
au développeur de créer un comportement spécifique pour un GameObject. 


Il est possible de créer et d'attacher autant de scripts que nécessaire sur un 
GameObject. Il ne faut ainsi pas avoir peur de découper vos comportements 
en plusieurs petits scripts chacun dédié à une tâche bien précise. 


Un script Unity peut être écrit en C#, ou en UnityScript. Dans le premier cas, 
il dérivera alors de la classe MonoBehaviour dérivant elle-même de la classe 
Component et n'aura pas d'héritage dans le second cas. Ce livre ne traitera que 
des scripts réalisés en C# mais les principes de base restent les mêmes. 


HRemarque 


Lors de la création d'un script, essayez de le garder générique au maximum 
afin de pouvoir le réutiliser sur un autre GameObject. 
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1.2 Ajouter un script à un GameObject 


L'ajout d'un script personnalisé est tout aussi aisé que l'ajout d'un composant. 
L'éditeur offre la possibilité de créer notamment des scripts en C# ou en Uni- 
tyScript. 


Dans la fenêtre Hierarchy, sélectionnez Create - Create Empty. 
Dans la fenêtre Inspector, sélectionnez Add Component - New Script. 


Entrez MyFirstScript comme nom de script et sélectionnez C Sharp dans 
la liste des langages disponibles. 


Constatez que le script est ajouté au GameObject dans l'Inspector : 


Dans la fenêtre Inspector - My First Script, double cliquez dans la zone 
de saisie MyFirstScript pour ouvrir l'éditeur de code. 


Le code (par défaut) du script s'ouvre alors dans l'éditeur de code : 


using UnityEngine; 
using System.Collections; 


public class MyFirstScript : MonoBehaviour { 


// Use this for initialization 
void Start () { 


} 
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// Update is called once per frame 
void Update () { 
} 
} 
Remarque 


Par défaut, l'éditeur est configuré pour ouvrir les scripts avec MonoDevelop. II 
est possible de changer ce comportement dans les paramètres de l'éditeur 
pour pouvoir utiliser un autre logiciel comme Visual Studio par exemple. 


Comment afficher des informations de débogage 


Il est primordial au cours des phases de développements d'un logiciel de 
pouvoir avoir des informations pendant l'exécution de celui-ci. Unity nous 
propose plusieurs solutions passant toutes par des méthodes statiques de la 
classe UnityEngine.Debug. 


Écrire dans la console 


Il est possible d'écrire directement dans la vue console intégrée à l'éditeur 
d'Unity. Pour cela, il faut choisir la méthode correspondant au niveau de 
criticité que l'on veut donner au message à écrire : 

— Log ou LogFormat pour les messages informatifs, 

— LogWarning pour les messages importants, 

— LogError pour les erreurs, 

— LogException pour afficher spécifiquement une exception. 

Il est à noter que pour chacune de ces méthodes, il est possible de fournir une 


instance de GameObject. Cela aura pour effet de le mettre en surbrillance dans 
la hiérarchie lorsque le message sera sélectionné dans la console. 


Voici un exemple de code mettant cela en exergue : 


Debug.LogFormat ("[Log] formatage : {0:F3}", 42); 


Debug.Log("[Log] Je suis un log", gameObject) ; 
Debug.LogError ("[Error] Je suis une erreur"); 
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Debug.LogWarning("[Warning]l Je suis un warning"); 
Debug.LogException(new ArgumentException ("Message de l'exception")); 


Voici le rendu dans la console une fois le code précédent exécuté : 


Remarque 


Il est aussi possible de vider la console en utilisant la méthode Debug.Clear- 
DeveloperConsole 


Dessiner des lignes dans la scène 


Il est aussi possible de dessiner des lignes de débogage directement dans la 
scène à l'aide de deux méthodes afin par exemple d'afficher un repère ou 
mettre en exergue une zone : 


- DrawLine dessine une ligne entre deux points, 

— DrawRay dessine un rayon dans une direction à partir d'un point d'origine. 
Ces deux méthodes dessinent l'élément pour une seule frame uniquement 
mais il est possible de spécifier une durée en seconde pour chacune. Il est aussi 
possible de spécifier la couleur à utiliser. 

Voici un exemple de code : 


//Affichage pour une frame d'une ligne cyan 
Debug.DrawLine (new Vector3(0, 0, 0), new Vector3(0, 1, O), 
Color.cyan) ; 
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Debug.DrawRay (new Vector3(0, 0, 0), new Vector3(0, 1, O), 


//Affichage d'un rayon pour 4 secondes 
Color.cyan, duration: 4); 


Il est important de remarquer que ce dessin ne se fera que dans la vue Scene 
de l'éditeur et non pas dans la vue Game. Rien ne sera donc dessiné sur un 
périphérique cible. 


Prendre le contrôle de l'exécution 


Finalement, ce n'est pas tout à fait de l'affichage mais cela reste indispensable : 
il est possible de mettre en pause l'éditeur directement via le code en utilisant 
la méthode Debug.Break : 


 Debug.Break() ; 


. Le cycle de vie des scripts 


Un script possède son propre cycle de vie lié à la fois au composant sur lequel 
il est placé et à l'application en elle-même. Ce cycle de vie est matérialisé par 
la présence de fonctions définies dans la classe C# du script. 


Fait assez déroutant au début pour un développeur rompu à la programma- 
tion objet, les méthodes correspondantes ne sont pas présentes sur la classe de 
base et il vous faudra les définir vous-même sans les surcharger (override). 


Dans tous les cas, les différentes méthodes du cycle de vie ne seront exécutées 
par Unity uniquement si le GameObject sur lequel est attaché le script est 
activé. 


Aussi, il est important de bien respecter les majuscules et minuscules définis- 
sant les méthodes, sous peine qu'elles soient ignorées par Unity. 
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3.1 Initialisation du script 


Trois méthodes principales existent pour initialiser un script : Awake, 
Start et OnEnable. Ces méthodes seront les premières exécutées dans la vie 
d'un script. 


3.1.1 La méthode Awake 


La méthode Awake est appelée une seule fois dès que votre script est présent 

sur un GameObiject de la scène : que le composant "script" soit activé ou non 

(le GameObject doit cependant être bien activé). Il s'agit donc de l'endroit pri- 

vilégié pour initialiser des éléments liés à ce script en question ne dépendant 
pas d'autres scripts ou GameObjects. 


Dans cet exemple de code, le texte "AffichageDuCycleDevie --> 
Awake" est affiché dans la console lorsque la méthode Awake est appelée par 
Unity. 


private void Awake () 


{ 
} 


Une fois le programme exécuté, la console est bien remplie malgré la désacti- 
vation du script AffichageDuCycleDeVie. 


Debug.Log("AffichageDuCycleDeVie --> Awake"); 


Remarque 


Vous remarquerez que la méthode n'est pas une surcharge, que sa signature 
déclare qu'elle ne retourne rien (void) et que son niveau d'accessibilité est 
private. Dans les exemples suivants, le niveau d'accessibilité ne sera plus 
nécessairement présent car cette valeur est facultative (il s'agit de la valeur 
par défaut en C#). 
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3.1.2 La méthode Start 


La méthode Start est appelée une seule fois dès que le script est activé 
(dynamiquement ou non). Dans tous les cas, elle ne sera appelée qu'après 
l'exécution de tous les scripts Awake. 


C'est en général l'endroit privilégié pour initialiser le script (initialisation des 
variables, obtention des ressources nécessaires, etc.) par rapport à son environ- 
nement car l'on s'assure ainsi que tous les autres scripts sont déjà bien initia- 
lisés. Cela est aussi avantageux d'un point de vue performance car 
l'initialisation de ce script ne se fera que si elle est réellement nécessaire 
lorsque le script est activé (pour rappel, un script est activé lorsque sa case à 
cocher est visible et cochée dans l’Inspector). 


Cette méthode est de plus définie par défaut lorsque vous demandez à Unity 
de créer un script via l'éditeur. Voici comment afficher le texte "Affichage- 
DuCycleDeVie --> Start" dans la console : 


// Use this for initialization 
void Start () 


{ 


Debug.Log("AffichageDuCycleDeVie --> Start"); 


} 


Remarque 


Ce sujet sera abordé plus tard dans le livre, mais cette méthode peut être 
définie comme une coroutine. 
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La méthode OnEnable 


La méthode OnEnable est appelée à chaque fois que le script ou le 
GameObject sur lequel il est apposé est activé. Elle est aussi appelée si le script 
est attaché/ajouté à un GameObiject. 


Son utilisation privilégiée est donc d'initialiser des variables temporaires utili- 
sées durant la durée d'activation du script. 


void OnEnable() 


{ 
} 


Debug.Log("AffichageDuCycleDeVie --> OnEnable"); 


BHRemarque 


Une façon simple de tester ce fonctionnement est d'utiliser la case à cocher 
du composant script dans l'Inspector de l'éditeur d'Unity. 


Les événements pendant la boucle de jeu 


La méthode Update 


Cette méthode est appelée à chaque frame affichée par Unity. Si l'application 
tourne à 60 fps, cette méthode sera donc appelée 60 fois par seconde ! 


C'est l'endroit privilégié pour mettre en place la logique associée au script. 
C'est généralement ici que sont réalisés les déplacements d'objets (non phy- 
siques), les tests d'interaction de l'utilisateur, les changements d'état ou encore 
l'orchestration d'animations. Il va sans dire que le code à exécuter doit être le 
plus performant possible afin d'avoir le meilleur fps possible. 


À ce stade, il peut être intéressant d'obtenir le temps écoulé depuis l'exécution 
de la dernière frame pour certains calculs de déplacement. Unity met à dispo- 
sition cette information sous la forme de la propriété statique deltaTime de 
la classe Time. Cette durée en seconde sous la forme d'un float sera donc par 
exemple d'environ 0,016666 si l'application tourne à 60 fps. 
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Voici un exemple de définition de la méthode Update : 


// Update est appelée une fois par frame 
private void Update () 


Debug.Log("AffichageDuCycleDeVie --> Update"); 


// Temps écoulé depuis la dernière frame 
float tempsEcoule = Time.deltaTime; 


} 


Vous remarquerez alors dans la console que le message est affiché, lors de 
l’exécution de notre test, 244 fois après seulement quelques secondes d'utili- 
satiOn : 


3.2.2 La méthode LateUpdate 


La méthode LateUpdate est toujours appelée une fois par frame après que 
chaque méthode Update ait été appelée. 


La présence de cette méthode permet d'ordonner l'exécution des différents 
calculs liés à la logique de votre application : dans la méthode Update, les 
calculs "classiques" sont réalisés et dans la méthode LateUpdate, les calculs 
dépendant du résultat de la logique réalisée dans la méthode Update sont 
faits. L'utilisation la plus courante de LateUpdate est la mise en place d'un 
GameObject suivant un autre : un script posé sur une caméra peut par 
exemple suivre pendant LateUpdate un objet dont la position est modifiée 
pendant les appels aux méthodes Update. 


Voici un exemple de code définissant la méthode LateUpdate : 


void LateUpdate () 


{ 
} 


Debug.Log("AffichageDuCycleDeVie --> LateUpdate"); 
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L'affichage dans la console témoigne bien du fait que la méthode LateUpdate 
est appelée sans faute derrière chaque appel de la méthode Update. 


La méthode FixedUpdate 


La méthode FixedUpdate est appelée à un rythme fixe non pas lié au rendu 
des frames mais à un timer (chronomètre) indépendant. Elle peut donc être 
appelée plusieurs fois par frame si le fps est petit ou pas du tout pendant une 
frame si le fps est très rapide. La propriété statique deltaTime de l'objet 
Time vue dans la section précédente retourne ainsi toujours la même valeur 
(0.02 dans l'exemple suivant). 


Cette méthode est cruciale lorsque l'on travaille avec le moteur physique 
d'Unity car c'est directement après elle que tous les calculs du moteur sont réa- 
lisés. Elle est donc l'endroit privilégié pour effectuer toutes les modifications 
sur les composants ayant trait à la physique de votre application (notamment 
les RigidBody). 


Voici sa définition et un exemple d'utilisation : 


void FixedUpdate () 


{ 


Debug.Log ("AffichageDuCycleDeVie --> FixedUpdate :" + Time.deltaTime) ; 


} 
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3.3 Les événements liés au rendu graphique 


3.3.1 


Il existe une dizaine de méthodes liées au cycle de rendu graphique d'Unity. 
Chacune répond à des besoins bien spécifiques et nous allons étudier ici les 
plus couramment utilisées. 


Les méthodes OnBecameVisible et OnBecamelnvisible 


Ces deux méthodes sont appelées lorsque l'objet sur lequel est attaché le script 
devient visible ou invisible par rapport à la caméra principale. Par visible, il 
faut comprendre "utilisé par Unity pour faire le rendu de la scène". Un objet 
peut par exemple ne pas être visible par la caméra mais être utilisé pour Le ren- 
du d'ombres qui seraient visibles. 


private bool visible; 
void OnBecameVisible () 


{ 
} 


void OnBecamelnvisible() 


_visible = true; 
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{ 
| _visible = false; 


} 


L'utilisation privilégiée de ces méthodes est d'activer ou de désactiver des 
calculs coûteux pour les performances si l'objet n'est pas visible à l'utilisateur. 
Elles peuvent aussi être utilisées pour afficher la présence d'éléments non 
visibles dans le champ de vision de l'utilisateur dans une mini-map. 


Remarque 
Il est tentant de vouloir désactiver des animations, des systèmes de particules 


ou autres effets visuels en utilisant ces deux méthodes mais cela est déjà fait 
par le moteur d'Unity et cela n'est donc pas nécessaire ! 


Attention, dans l'éditeur les caméras utilisées par la vue Scene déclenchent 
elles aussi ces deux méthodes lorsque vous vous déplacez dans la scène. Une 
astuce couramment utilisée consiste à vérifier le nom de la caméra pour savoir 
s'il s'agit de celle de la scène ou non : 


private void OnBecamelnvisible() 


{ 
// Test s'il s'agit de la caméra de la vue Scene 
if (Camera.current != null 
&& Camera.current.name.Equals ("SceneCamera")) 
{ 
// Ne rien faire si cela est le cas 
return; 
} 
Debug.Log("AffichageDuCycleDeVie --> OnBecamelnvisible"); 
_visible = false; 
} 
La méthode OnGuUlI 


La méthode OnGUI (attention à bien mettre GUI en majuscules) sert à dessi- 
ner des éléments d'interface utilisateur (GUI). Elle fait partie de l'héritage 
d'Unity puisque ce système d'affichage, qui était peu utilisé au final, a été rem- 
placé par un nouveau système dans la version 4.6. Ce dernier sera présenté in 
extenso dans un prochain chapitre. 
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Il est recommandé par Unity de ne plus utiliser ce système mais il est impor- 
tant de connaître son existence car il est toujours utilisé par Unity dans son 
éditeur et dans certains programmes historiques que vous souhaiteriez main- 
tenir. 


Contrairement à ce que l'on peut imaginer, la méthode OnGUI peut être appe- 
lée plusieurs fois par frame. Voici un exemple dessinant un bouton et testant 
s'il a été cliqué par l'utilisateur : 

private void OnGUI () 


{ 


if (GUI.Button(new Rect (10, 10, 150, 42), "mon bouton exemple")) 


{ 
} 


Debug.Log("Bouton cliqué"); 


} 


Le rendu est le suivant dans la vue Scene : 


La méthode OnDrawGizmos et OnDrawGizmosSelected 


La méthode OnDrawGizmos est utilisée uniquement dans l'éditeur. Elle 
permet d'afficher des "gizmos" dans la vue Scene d'Unity. Cette méthode est 
appelée fréquemment par Unity mais uniquement si le composant script n'est 
pas replié dans l'Inspector. 


La méthode OnDrawGizmosSelected a un comportement similaire mais 
n'est affichée que si le GameObject (ou un de ses parents) utilisant le script est 
sélectionné dans l'Inspector. 


L'utilisation privilégiée de ces méthodes est de mettre en avant des objets 
importants en phase d'édition dans la scène. 


129 


130 Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Dans cet exemple de code, un cube rose est affiché lorsque le GameObiject 
contenant le script est sélectionné : 


void OnDrawGizmosSelected() 


{ 


Gizmos.color = Color.magenta; 
Gizmos.DrawCube (transform.position, new Vector3(1,1,1)); 


} 


Le rendu dans la vue Scene est alors le suivant : 


Remarque 


Attention, ces deux méthodes seront appelées même si le GameObject est 
désactivé dans la hiérarchie. 


3.4 Les événements de fin de vie ou de remise à zéro 


Unity nous donne la main sur cinq événements principaux concernant la fin 
de vie ou la remise à niveau d'un script. Il s'agit de fonctionnalités cruciales car 
elles permettent de nettoyer les ressources utilisées. 


3.4.1 La méthode OnDisable 


La méthode OnDisable est appelée à chaque fois que le script ou le 
GameObiject sur lequel il est apposé est désactivé. Elle est aussi appelée si le 
script est enlevé de son GameObiject. 
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Son utilisation privilégiée est donc de mettre ici le code de nettoyage, non 
définitif, des différents composants utilisés par le script. 


private void OnDisable() 


Debug.Log("AffichageDuCycleDeVie --> OnDisable"); 


L'affichage dans la console est alors le suivant : 


HRemarque 


Une façon simple de tester ce fonctionnement est d'utiliser la case à cocher 
du composant script dans l'Inspector de l'éditeur d'Unity. 


La méthode OnDestroy 


Cette méthode est appelée lorsque le script est détruit par Unity après que 
tous les appels à Update soient réalisés. Attention, l'appel n'est réalisé que si 
le script était bien actif avant sa destruction. De plus, les appels à OnDisable 
seront tous effectués avant les appels à OnDestroy. Un script peut être 
détruit en plusieurs occasions : 


— La scène dans laquelle est son GameObiject attaché est détruite. 
— Un appel explicite à Destroy sur ce script est effectué par le code. 


— Le composant est supprimé du GameObiject sur lequel il est attaché. 


Il s'agit de la méthode privilégiée pour effectuer le nettoyage définitif des 
ressources utilisées par le script. 


Voici un exemple de code définissant cette méthode : 


private void OnDestroy() 


{ 


Debug.Log("AffichageDuCycleDeVie --> OnDestroy"); 
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3.4.3 La méthode OnApplicationQuit 


La méthode OnApplicationQuit est appelée juste avant que l'application 
ne soit quittée. Le comportement est différent en fonction des plateformes : 


— Éditeur : la méthode est appelée lorsque le "mode de jeu" est quitté. 
— Player web : la méthode est appelée lorsque la page est quittée. 


— PC/Mac, Consoles, Android : la méthode est appelée lorsque l'application 
est quittée. 


— iOS (iPhone, iPad, iWatch) : la méthode est appelée lorsque l'application est 
quittée mais le comportement par défaut sur ces plateformes mobiles est de 
suspendre l'application au lieu de la quitter. Il est possible de choisir le com- 
portement voulu "Behavior On Background" dans la configuration du 
player. 

— Windows Store App, Windows Phone : la méthode n'est jamais appelée car 
un tel événement n'existe pas sur ces plateformes. Il est recommandé d'uti- 
liser la méthode OnApplicationFocus pour avoir un comportement 
équivalent. 


L'utilisation privilégiée de cette méthode est de sauvegarder sur le disque les 
différents paramètres de l'utilisateur ou son avancement dans le jeu. 


Voici un exemple définissant cette méthode : 


void OnApplicationQuit () 


{ 
} 


Debug.Log("AffichageDuCycleDeVie --> OnApplicationQuit"); 
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La capture d'écran ci-dessous montre l'option Suspend choisie sur les plate- 
formes iOS et Android. 
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La méthode OnApplicationFocus 


La méthode OnApplicationFocus est appelée lorsque le player Unity 
exécutant l'application perd ou gagne le focus. Cette méthode est un peu plus 
particulière que les autres précédemment évoquées car elle prend en para- 
mètre un booléen indiquant l'état du focus. Si l'application a le focus, true et 
false dans les autres cas. 


L'utilisation privilégiée de cette méthode est de déterminer s'il faut mettre 
l'application en pause car l'utilisateur ne l'utilise plus. Comme vu précédem- 
ment, elle est aussi pratique dans les applications Windows (Phone) pour sau- 
vegarder les différents paramètres/états du jeu. 


Voici un exemple de code illustrant cette utilisation : 


void OnApplicationFocus (bool focusStatus) 


{ 


if (focusStatus) 


{ 
} 
else 


{ 
} 


Debug.Log("AffichageDuCycleDeVie --> OnApplicationFocus : OUI."); 


Debug.Log("AffichageDuCycleDeVie --> OnApplicationFocus : NON."); 


Remarque 


Ce sujet sera abordé plus tard dans le livre, mais cette méthode peut être 
définie comme une coroutine. 


La méthode Reset 


La méthode Reset est appelée lorsque le script est ajouté pour la première fois 
sur un GameObject ou lorsque le développeur sélectionne l'entrée de menu 
Reset dans la fenêtre de l'Inspector. 
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Pour afficher l'entrée de menu Reset dans l'Inspector d'Unity, il est nécessaire 
de cliquer sur l'icône des paramètres (roue dentée) : 


Remove Component 


Move Up 

Move Eown 

Copy Component 

Paste Component As New 
Paste Component Velues 


Edit Script 


L'utilisation privilégiée de cette méthode est de mettre la valeur par défaut de 
différentes propriétés permettant de paramétrer le script (plus de détails à ce 
sujet dans la suite de ce chapitre). 


Voici un exemple de code définissant cette méthode : 


public float parametrelmportant; 
public Color couleurPrimordiale; 


void Reset () 


{ 
_parametrelmportant = 42; 
_couleurPrimordiale Color.pink; 


Remarque 


Une bonne pratique est de définir cette méthode pour mettre les bonnes 
valeurs par défaut d'un script et de ne pas uniquement se reposer sur les 
valeurs assignées au champ définissant les paramètres. 


3.4.6 La méthode OnValidate 


La méthode OnValidate est appelée à chaque modification d'une valeur du 
script dans l'Inspector. 


C'est donc la méthode idéale permettant de modifier un affichage temporaire 
lorsque l'application n'est pas en prévisualisation dans Unity. 
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4. Comment les scripts interagissent avec l'extérieur 


4.1 Permettre la configuration d'un script 


Un script a souvent besoin d'être configuré pour répondre au contexte où il est 
placé. Cela est notamment très pratique lorsque vous mettez ces scripts à 
disposition d'autres développeurs ou intégrateurs. 


Unity propose une solution simple à ce problème : tous les champs publics 
seront visibles dans l’Inspector avec l'éditeur de valeur le mieux approprié. 


‘ Ainsi, si l'on ajoute un champ de type boolean IsVeryImportant à un 
script Interactions, il sera visible dans l'éditeur. 


public class Interactions : MonoBehaviour 


{ 


public bool IsVeryImportant; 


} 


4.2 Accéder au GameObject parent 


L'élément le plus important pour un script est sans doute le GameObject 
parent auquel il est attaché. Il est très simple d'y accéder car il est exposé par 
la propriété gameObject de la classe MonoBehaviour dont héritent tous 
les scripts. 


Il est alors possible de lire les propriétés de base de celui-ci comme le nom ou 
le tag : 


var nomDuGO = gameObject.name; 
var tagDuGO = gameObject.tag; 
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Manipuler les composants de base 


Trouver un composant déjà ajouté 


Pour trouver un composant déjà présent sur un GameObiject il suffit d'utiliser 
la méthode Get Component. Celle-ci retourne nul1 si le composant n'existe 
pas sur ce GameObject. 


var camera = gameObject.GetComponent<Camera> (); 
bool cameraExist = camera !- null; 


Il est important ici de noter que la propriété gameObject expose elle-même 
plusieurs composants "classiques" sous la forme de propriétés : camera, co1- 
lider, light, etc. Ces méthodes bien pratiques permettent d'accéder aux 
composants les plus communs sans recourir à la lourdeur de Get Component. 
Cependant elles sont depuis Unity 5 marquées comme obsolètes et pourraient 
disparaître dans une version ultérieure d'Unity. 


Ajouter un composant 


À partir d'un script, il est possible d'ajouter au GameObiject parent un nou- 
veau composant directement au niveau du code en utilisant la méthode Add- 
Component. Celle-ci prend en paramètre le type de composant à ajouter dont 
une nouvelle instance sera créée à la volée. Il est aussi possible d'utiliser la sur- 
charge "générique" de cette méthode. 


gameObject .AddComponent (typeof (Camera) ) ; 
gameObject .AddComponent<Camera> (); 


Supprimer un composant 


Pour la suppression d'un composant, il n'existe pas de méthode DeleteCom- 
ponent<T> (),on utilisera donc la méthode Destroy () qui permet de sup- 
primer un GameObject, un composant ou un asset en le passant en paramètre. 


Mesh mesh = gameObject.GetComponent<Mesh> () ; 
if (mesh !-= null) 


{ 
} 


Destroy (mesh) ; 
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Il est aussi possible de passer un second paramètre indiquant la durée en 
secondes après laquelle l'objet sera détruit : 


// Destruction dans 5..4...3 ... secondes :) 
Destroy (gameObject,5); 


Trouver un composant dans une hiérarchie 
de GameObjects 


Il peut être intéressant de retrouver un composant en particulier dans une hié- 
rarchie de GameObijects. Pour cela, Unity expose quatre méthodes : 


— GetComponentInChildren : retourne le premier composant du type 
passé en paramètre dans les enfants du GameObiject courant. 


- GetComponentsInChildren : retourne tous les composants du type 
passé dans les enfants du GameObject courant. 


— GetComponentInParent : retourne le premier composant trouvé du 
type passé en paramètre dans les parents du GameObject courant. 


- GetComponentsInParent : retourne les composants du type passé en 
paramètre dans les parents du GameObject courant. 


Par défaut, seuls les GameObijects actifs sont considérés mais il est possible de 
modifier ce comportement en passant un paramètre includelnactive 
pour chacune de ces méthodes. 


Voici un exemple retournant tous les scripts Interactions dans les enfants 
du script courant : 


.GetComponentsInChildren<Interactions> ( 


var allScripts = gameObject 
includelnactive: true); 
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Utiliser l'éditeur et un binding pour obtenir un composant 


Ces méthodes sont utiles lorsque l'on sait où se trouve le composant que l'on 
recherche. Cela peut par contre devenir contre-productif s'il faut parcourir 
tous les objets de la scène à chaque recherche. 


Unity propose donc une autre méthode : définir un champ public du type sou- 
haité au niveau du script et utiliser l'éditeur pour le fournir. Un composant est 
alors considéré comme un élément de configuration du script par Unity. 


Définissons par exemple un champ de type Camera au niveau d'un script 
Interactions : 


public class Interactions : MonoBehaviour 


{ 
} 


public Camera CameraRecherche; 


Un nouveau champ apparaît alors au niveau du script dans l'éditeur. Je peux 
ensuite faire un glisser-déposer de la caméra directement sur mon script pour 
y voir ce champ assigné. Unity se chargera alors à l'exécution de me fournir la 
bonne valeur. 


Les événements Unity 


Unity permet de définir des événements personnalisés sur un script. Ceux-ci 
sont très similaires aux événements .NET classiques mais sont mieux pris en 
charge dans l'Inspector. 
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Déclarer un événement simple 


La déclaration d'un événement simple se fait dans le code de la même manière 
qu'un champ public : 


Créez un nouveau script C# (nommé UnityEvents par exemple) dans la 
vue Project. 


Assurez-vous de bien importer le namespace UnityEngine .Events dans 
celui-ci. 


DDéclarez un champ public de type UnityEvent en choisissant le nom que 
vous souhaitez donner à l'événement. Pensez bien à créer une instance de 
cet objet au moment de la déclaration. 


ZAu moment où vous le souhaitez, déclenchez l'événement en appelant la 
méthode Invoke sur l'instance. 


Voici un exemple de code déclarant l'événement 11SePasseQuelqueChose 
et le déclenchant dès le démarrage du script : 


using UnityEngine.Events; 
public class UnityEvents: MonoBehaviour 


{ 


// Déclaration de l'événement 
public UnityEvent 11SePasseQuelqueChose = new UnityEvent (); 


void Start) 


{ 
// Déclenchement de l'événement 
11SePasseQuelqueChose.Invoke(); 


} 

} 
Réagir à la levée d'un événement 
Unity permet de configurer la réaction à un événement depuis l'Inspector. En 
associant le script précédemment écrit à un GameObiject, une liste d'élément 
titré du nom de l'événement apparaît sur celui-ci. En cliquant sur le symbole 


"+", nous rajoutons une réaction, aussi appelée gestionnaire d'événement, 
pour cet événement. 
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Une zone d'assignation d'un objet, où il est écrit "None Object" par défaut, 
apparaît et permet d'assigner un GameObject ou sera définie la réaction. Dans 
notre exemple, assignons le GameObject même où est défini l'événement. 


Il est alors possible de choisir parmi trois types de réactions à un événement : 


— Le changement de valeur d'un champ de type simple : un booléen, un entier, 
une chaîne de caractères, etc. 


— L'appel d'une méthode prenant zéro ou un paramètre simple défini dans 
l'Inspector comme argument. On parle ici de binding statique. 


— L'appel d'une méthode prenant zéro ou plusieurs paramètres simples passés 
par le code appelant. On parle ici de binding dynamique car c'est le code, au 
runtime, qui donne les valeurs des arguments. 


Une combobox (avec la valeur No Function par défaut) apparaît alors et pro- 
pose sur un premier niveau de choisir un composant du GameObiject et sur un 
deuxième niveau la réaction à choisir. Une fois cette réaction choisie, il est 
possible de spécifier la valeur du paramètre s'il s'agit d'un binding statique. 


boot isStatic 

int layer Transform 
string name UnityEvents 
string tag 

BroadcastMessage (string) 

SendMessage (string) 

SendMessageUpwards (string) 

SetActive (bool) 
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Voici un exemple de configuration, appelant une méthode "Reponse- 
Simple", modifiant le nom du GameObject en "Nom changé" et appelant la 
méthode SetActive de celui-ci en passant true comme paramètre (via la 
case à cocher) : 


Déclarer un événement complexe 


La classe UnityEvent ne permet pas de passer un argument dynamique au 
moment de l'invocation. Unity propose la création d'événements pouvant 
prendre jusqu'à n paramètres en arguments. 


Voici la procédure à suivre pour créer un événement complexe : 


Créez un nouveau script C# (nommé UnityComplexEvents par exemple) 
dans la vue Project. 


Assurez-vous de bien importer le namespace UnityEngine.Events dans 
celui-ci. 


DDéclarez à la fin de ce fichier une classe dérivant de la version générique de 
la classe UnityEvent en spécifiant les types de paramètres souhaités. Le 
nom de cette classe sera le nom de l'événement complexe. 


DApposez l'attribut Serializable sur cette classe afin de la rendre visible 
dans l'éditeur. 


DDéclarez un champ public du type créé dans la classe correspondant au 
script. Pensez bien à créer une instance de cet objet au moment de la décla- 
ration. 


© Editions ENI - AI rights reserved 


143 


Le système de scripting 
Chapitre 4 


Voici un exemple définissant un événement MonEvenement Complexe pre- 
nant en paramètre une chaîne de caractères, un booléen et une autre chaîne de 
caractères : 


using UnityEngine.Events; 


public class UnityComplexEvents : MonoBehaviour 


{ 


// déclaration de l'événement complexe 
public MonEvenement Complexe I1SePasseQuelqueChoseComplexe 
= new MonEvenement Complexe () ; 


} 


[Serializable] 
public class MonEvenementComplexe : UnityEvent<string, bool, string> 


{ 
} 


Il est alors possible de déclencher cet événement depuis votre code en appelant 
la méthode Invoke. Celle-ci prendra alors en paramètre les arguments à four- 
nir aux abonnés de cet événement. 


11SePasseQuelqueChoseComplexe 
.invoke ("bonjour", true, "aurevoir'); 


4.6.4 Écrire sa propre méthode de réaction à un événement 


Pour écrire une méthode de réaction à un UnityEvent, il suffit smplement 
de déclarer une méthode respectant les nombres et types des paramètres et ne 
retournant rien (void) : 


— Zéro où un paramètre simple pour les bindings statiques. 


— Le nombre de paramètres exact avec le bon type pour les bindings dyna- 
miques. 


Voici les définitions de deux gestionnaires d'événements pour les deux précé- 
demment créés : 


public void ReponseSimple() 


{ 
} 


public void ReponseComplexe (string pl, bool p2, string p3) 


{ 


Debug.Log("ReponseSimple."); 
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j Debug-.Log (!Reçu..: "4 pl o+etn M + p24: Mo par art, M); 
} 


5. Écriture de code pour une seule plateforme 


L'objectif annoncé d'Unity est d'écrire un même code pour toutes les plate- 
formes disponibles. Il peut cependant être intéressant de vouloir profiter dans 
certains cas des spécificités de telle ou telle plateforme. 


5.1 Utiliser les propriétés de la classe Application 


La méthode la plus naturelle pour un développeur va sans doute être d'utiliser 
les propriétés statiques de la classe Application: 


- Application.isEditor : retourne true si le code est exécuté depuis 
l'éditeur. 
- Application.platform retourne la plateforme actuellement utilisée. 


Voici un exemple testant si le code est exécuté dans l'éditeur, sur la PS4 ou sur 
une autre plateforme : 


if (Application.isEditor) 


{ 
} 


else if (Application.platform == RuntimePlatform.PS4) 


{ 
} 
else 


{ 
} 


Debug.Log('"Non disponible dans l'éditeur"); 


Debug.Log('"Non disponible sur PS4"); 


// Autre code 


HRemarque 


Attention, plusieurs valeurs de l'énumération Runt imePlat form sont marquées 
comme obsolètes. 
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Utiliser les directives de précompilation 


Une autre méthode pour mettre en place du code pour une seule plateforme 
est d'utiliser les variables de précompilation mises à disposition par Unity. En 
voici les principales valeurs : 


— UNITY_EDITOR : le code est compilé pour l'éditeur. 


— UNITY_STANDALONE : le code est compilé pour une exécution sous la 
forme d'un exécutable sur PC ou Mac. 


— UNITY_IOS : le code est compilé pour iOS. 

— UNITY_ANDROID : le code est compilé pour Android. 

— UNITY_WP8 : le code est compilé pour Windows Phone 8.0. 
— UNITY_WEBGL : le code est compilé pour le player WebGL. 


Voici un exemple de code affichant un texte dans la console uniquement dans 
l'éditeur : 
#if UNITY EDITOR 
Debug.Log('"Non disponible dans l'éditeur"); 
Helse 
// Code natif 
#Hendif 


MRemarque 


Attention, en utilisant cette méthode, le code ignoré par une directive de 
précompilation sera tout simplement absent du binaire final. 


Remarque importante, plusieurs variables de précompilation peuvent être 
définies simultanément. Ainsi, si le player PC/Mac est choisi comme valeur 
courante, alors les directives UNITY_STANDALONE et UNITY EDITOR seront 
définies toutes les deux. Ce code n'aura par exemple pas pour effet d'exécuter 
le code pour la plateforme "Standalone" : 


#if UNITY EDITOR 
Debug.Log('"Non disponible dans l'éditeur"); 
#elif UNITY STANDALONE 
// Code sur plateforme Windows 
Helse 
// Code autre 
Hendif 
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Exécuter des actions simultanément 
avec les coroutines 


P gu “pe 
Définition 
Une méthode est, par défaut, exécutée entièrement durant une même frame 
dans Unity. En caricaturant le processus, Unity parcourt pour chaque frame 
les scripts qu'il doit considérer, les exécute, et une fois cela terminé, il passe à 


la frame suivante. La durée d'une frame est donc entièrement déduite du 
temps d'exécution des scripts. 


Une coroutine consiste en une méthode dont l'exécution est potentiellement 


6.2 


faite sur plusieurs frames successives ou non. 


Pourquoi les coroutines sont nécessaires 


Prenons pour exemple un script devant rapprocher la caméra d'un objet petit 
à petit pour illustrer la problématique. Pour cela, nous allons manipuler la 
caméra et la déplacer de 100 pixels dans une boucle for avec ce code : 


public class CoroutinesBasics : MonoBehaviour 


{ 


public Camera TargetCamera; 
private bool launched = false; 


void Update () 


{ 
// Si le déplacement n'est pas déjà lancé 
if (!_launched) 
{ 


_launched = true; 
// Déplacement de la caméra de 100 pixels 
for (int i = 0; i < 100; i++) 


{ 
} 


TargetCamera.transform.Translate(0, 0, 1); 


> 
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Ce code n'aura pas du tout l'effet attendu ! En effet, comme il est exécuté 
sur la même frame, la caméra va, pour l'utilisateur, se déplacer d'un coup de 
100 pixels. Pour obtenir l'effet attendu, il est nécessaire de répartir le déplace- 
ment sur plusieurs frames. Une solution consiste à calculer le temps passé 
depuis la dernière frame et de n'effectuer qu'un déplacement correspondant à 
la vitesse voulue. Voici le code correspondant : 


public class CoroutinesBasics : MonoBehaviour 


{ 


public Camera TargetCamera; 
private float movementToApply = 100; 


void Update () 


{ 


// Rapprochement si la cible n'est pas encore atteinte 
if (_movementToApply > 0) 


{ 


// Velocité voulue = 100 pixels pour 5 secondes 
var velocity = 100 / 5; 


// Calcul du déplacement 

var move = Mathf.Min( 
Time.deltaTime * velocity, 
_movementToApply) ; 


à 


// décrémentation du mouvement restant à appliquer 
_movementToApply -= move; 


// Application du déplacement 
TargetCamera.transform.Translate(0, 0, move): 


} 


Cela fonctionne mais il faut bien l'avouer, le code n'est ni simple à mettre en 
place ni simple à relire. Les coroutines sont donc là en partie pour mettre en 
place un code plus simple de façon plus efficace. 
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Mise en œuvre 


Déclarer une coroutine 


Une coroutine dans Unity correspond à la déclaration d'un énumérateur, c'est- 
à-dire à une méthode retournant un objet implémentant IEnumerator et 
prenant autant de paramètres que nécessaire. 


Voici la déclaration de la coroutine permettant de déplacer la caméra d'un 
certain nombre de pixels : 


private IEnumerator MoveCamera (float movementToApply) 


Écrire le corps de la coroutine 


Le code d'une coroutine est standard à ceci près qu'il faut indiquer au moteur 
d'exécution à quel moment l'exécution doit être interrompue. 


Pour cela, le mot-clé C# yield est utilisé pour retourner soit un objet .NET 
classique (nul1 par exemple, l'exécution sera reprise à la prochaine frame) ou 
break pour arrêter l'exécution de la coroutine. 


Unity met aussi à disposition du développeur plusieurs objets afin de contrô- 
ler plus finement les conditions de reprise de l'exécution : 


- WaitForEndOfFrame : demande à Unity d'exécuter la suite à la fin de la 
frame courante. Notamment utile lorsque l'on doit attendre que la scène 
soit totalement rendue pour en faire une capture. 


- WaitForFixedUpdate : demande à Unity d'exécuter la suite du code lors 
du prochain FixedUpdate. Pratique lorsque vous manipulez des objets liés 
à la physique. 

— WaitForSeconds : demande à Unity d'exécuter la suite du code après un 
certain nombre de secondes. 


— L'objet WWW abordé dans un autre chapitre demande à Unity d'exécuter la 
suite du code lorsque la requête web est terminée. 


© Editions ENI - All rights reserved 


6.3.3 


Le système de scripting 
Chapitre 4 


Voici alors le code complet permettant le déplacement de la caméra : 


private IEnumerator MoveCamera (float movementToApply) 


{ 
// Nélocité voulue = 100 pixels pour 5 secondes 
var velocity = 100 / 5; 


// Rapprochement si la cible n'est pas encore atteinte 
while (movementToApply > 0) 


// Calcul du déplacement 
var move = Mathf.Min(Time.unscaledDeltaTime * velocity, movementToApply) ; 


// décrémentation du mouvement restant à appliquer 
movementToApply -= move; 


// Application du déplacement 
TargetCamera.transform.Translate(0, 0, move); 


// La suite à la prochaine frame 
yield return null; 


} 


// Fin de la coroutine (pour l'exemple car inutile ici) 
yield break; 


Le premier constat est que l'utilisation d'une coroutine permet de dédier une 
seule méthode à un seul objectif (le déplacement de la caméra ici) et d'avoir un 
code plus lisible. 


Lancer une coroutine 


Le lancement d'une coroutine se fait au travers de la méthode StartCorou- 
tine définie sur la classe MonoBehaviour. Il en existe trois surcharges 
différentes. La première et la plus simple d'utilisation prend en paramètre 
l'TEnumerator retourné par la coroutine. Dans ce cas, on effectue directe- 
ment l'appel en passant les paramètres à la coroutine : 


// Lancement en utilisant un appel direct 
Coroutine coroutine = StartCoroutine (MoveCamera (100) ); 


Les autres surcharges prennent en paramètre le nom de la coroutine et les 
éventuels arguments nécessaires. 


// Lancement en utilisant le nom 
Coroutine coroutine = StartCoroutine ("MoveCamera", 100f); 
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Cette utilisation est un peu plus coûteuse en termes de performances mais 
permet de nommer de façon explicite la coroutine que l'on Le permet- 
tant de la stopper si nécessaire. 


Stopper une coroutine 


Par défaut, une coroutine s'arrête d'elle-même lorsqu'elle rencontre l'instruc- 
tion break ou lorsque le script et/ou le GameObject la portant sont suppri- 
més. 


Pour stopper une coroutine manuellement, Unity met à notre disposition la 
méthode StopCoroutine prenant en paramètre la coroutine à stopper ou le 
nom de la méthode appelée. Cette méthode est sur la classe de base MonoBe- 
haviour dont héritent les scripts. 


// Utilisation de la coroutine lancée 
StopCoroutine (coroutine) ; 


// Utilisation du nom de la coroutine 
StopCoroutine ("MoveCamera") ; 


. Quelques design patterns utiles 


Singleton 

Définition 

Le singleton est un design pattern classique du développement logiciel qui ne 
sera pas décrit in extenso dans ce livre. L'idée de base consiste à avoir une 
instance unique d'un objet afin de lui laisser la responsabilité d'orchestrer 
différentes actions, de gérer la durée de vie d'objets sous sa responsabilité ou 


encore d'être un référent unique accessible facilement par les autres compo- 
sants techniques de la solution. 


Le développement Unity ne fait pas exception et c'est un composant vite 
incontournable. 
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implémentation du singleton dans Unity 


L'implémentation technique du singleton peut être améliorée en faisant déri- 
ver la classe finale de MonoBehaviour afin de pouvoir bénéficier de tous les 
événements liés à son cycle de vie et y réagir. Pour que ceux-ci soient réelle- 
ment effectifs, il faut bien veiller à attacher ce script à un GameObiject. 
L'astuce pour réunir ces deux états de fait consiste à créer un GameObiject à la 
volée que l'on placera dans la scène si le script n'en a pas encore. 


La première étape consiste à créer une classe de base pour nos futurs singletons 
se chargeant de cette logique primaire. La méthode FindObjectOfType 
d'Unity permet de récupérer une instance (la première qu'il trouve) d'un objet 
du type fourni dans la scène s'il existe (ou de retourner nul1 le cas échéant). 
Cette méthode trouve toute son utilité dans ce cas : 


public class BaseSingletonUnity«<T> 
: MonoBehaviour where T : MonoBehaviour 
{ 


protected static T instance; 


public static T Instance 
{ 
get 
{ 
if (_instance == null) 
{ 
// récupération d'une instance existante du script 
_instance = (T)FindObjectOfType (typeof (T) ); 


// On en crée une s'il n'y en a pas 
if (_instance == null) 
{ 
var o = new GameObject ("Singleton#<" + typeof (T) + ">"); 
_instance = o.AddComponent<T> () ; 
} 
} 


// On retourne l'instance 
return _instance; 
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Une fois cette classe créée, il est possible d'en dériver pour créer un singleton 
, P 

qui portera la logique spécifique à sa raison d'être. Dans cet exemple, on 

expose uniquement une méthode de log dans la console : 


public class BaseSingletonUnityExample 
: BaseSingletonUnity<BaseSingletonUnityExample> 
{ 


public void Log() 


{ 
} 


Debug.Log("Bonjour le monde."); 


} 
Elle peut alors être appelée de cette manière : 


 BaseSingletonUnityExample.Instance.Log(); 


À noter que le GameObiject créé avec son script attaché sera aussi visible dans 
la hiérarchie à partir de sa première utilisation : 


Instanciation du singleton 


Cette implémentation permet notamment deux manières d'instancier et 

d'utiliser un singleton : 

— laisser la classe BaseSingletonUnity créer un GameObiject et Le script, 

— ajouter soi-même un script (du type final BaseSingletonUni- 
tyExample) sur un GameObiject de la scène pour le retrouver simplement. 


Dans tous les cas, une seule et unique instance sera présente. 


Remarque 


Avec l'implémentation faite, les singletons seront détruits en même temps que 
la scène. Il est possible d'empêcher ce comportement en appelant la 
méthode DontDestroyOnLoad lors de la création du GameObject portant le 
script. 
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Object Pool 


La problématique à résoudre 


Il est fréquent dans une scène 2D ou 3D de devoir instancier une multitude 
d'objets ayant une durée de vie assez limitée. L'exemple le plus parlant étant 
sans doute un nuage de particules. 


Ce type de comportement peut mener à une problématique nommée la "frag- 
mentation de la mémoire". À force de créer des objets et de les libérer, il n'y a 
plus forcément assez de place et des mécanismes comme le garbage collector 
doivent entrer en jeu pour faire une ou plusieurs choses : 


— compacter la mémoire afin de pouvoir créer de nouveaux objets, 

— faire une passe complète de nettoyage des objets "morts" en mémoire. 

Ces deux actions sont très coûteuses et ont des conséquences notables sur les 
performances du rendu de la scène graphique. 

La solution théorique 


La solution à mettre en place est un réservoir d'objets à réutiliser. Plutôt que 
de créer un nouvel objet et de le détruire après utilisation, un nombre suffisant 
de ces objets sont créés et réutilisés. Cette solution est le design pattern 
"Object Pool". 


Elle consiste en ces étapes successives : 


créer un objet "réservoir", 


créer dans celui-ci une liste d'objets, 


— à chaque besoin, prendre le premier objet non utilisé dans ce réservoir et le 
marquer comme utilisé, 


à la fin de l'utilisation, indiquer cet objet comme disponible à nouveau. 


L'inconvénient de cette méthode est que dans tous les cas un nombre choisi 
d'objets vont occuper la mémoire. Il faut donc choisir finement ce nombre en 
fonction de l'utilisation faite : trop bas, le réservoir se videra trop vite, trop 
haut, une consommation mémoire excessive sera faite. 
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7.2.3 Mise en œuvre technique 


La mise en œuvre consiste à l'utilisation des différents outils du framework 
.NET et Unity plutôt qu'à la création de la classe de base comme dans 
l'exemple du singleton. Pour illustrer la mise en place, nous allons créer une 
mini-scène 2D consistant en un élément représenté par une licorne lançant 
des balles roses vers le haut de l'écran toutes les 0.2 seconde. 
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Le script d'une balle va être très simple : il déplace son GameObject à une 
vitesse fixe vers le haut et appelle une méthode de désactivation au bout d'une 
durée paramétrable sur le script (ici la valeur est fixée à 3 secondes). La méthode 
Invoke d'Unity permet de faciliter la mise en œuvre de ce comportement : 


public class BulletOwner : MonoBehaviour 


{ 


public float LifeTime = 3; 


// Use this for initialization 
void OnEnable ({) 


{ 
// Appel de DisableMyself après une durée LifeTime 
Invoke ("DisableMyself", LifeTime); 


} 


void Update () 


{ 
// déplacement de la balle vers le haut 
transform.Translate(0, 6 * Time.deltaTime, O); 


} 


private void DisableMyself () 


{ 


// Désactivation du GameObject 
gameObject.SetActive (false); 


} 
Nous avons alors ces différents postulats à utiliser : 


— une balle se déplaçant est nécessairement "active", 
— une balle inutilisée est désactivée. 


Le script du lanceur va utiliser ces informations pour créer et stocker un 
nombre (configurable) de balles au lancement (dans sa méthode Start) qu'il 
va désactiver immédiatement. 


// Prefab d'une balle 
public GameObject BulletPrefab; 


public uint PoolSize = 30; 
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// Le réservoir est une simple liste .NET 
private readonly List<GameObject> bulletPool 


= new List<GameObject>(); 


void Start) 


{ 


} 


//Remplissage du réservoir 
for (int i = 0; i < PoolSize: i++) 
{ 
// On instancie un prefab 
var instantiate = Instantiate(BulletPrefab); 
instantiate.SetActive (false); 
_bulletPool .Add(instantiate); 


} 


// Lancement d'une balle toutes les 0.2 seconde 
InvokeRepeating("LaunchBullet", 1, O0.2£); 


L'utilisation de la méthode InvokeRepeating permet d'appeler Launch- 
Bullet toutes les 0.2 seconde après un délai initial d'une seconde. 


Pour chaque lancement d'une balle, il va alors parcourir le réservoir pour 
trouver la première qui n'est pas active et l'activer après l'avoir positionnée au 
bon endroit. Cela va déclencher le lancement du script de déplacement de la 
balle. Si aucune balle n'est disponible, le lanceur ne fera rien. 


private void LaunchBullet () 


{ 


GameObject bullet = null; 


// Recherche de la première balle disponible 
foreach (var o in bulletPoo!l) 


{ 


if (o.activeSelf == false) 

{ 
// Réservation de la balle 
o.SetActive (true); 
bullet = o; 


// fin de la recherche 
break; 
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// Réservoir épuisé 
if (bullet == null) 


{ 
} 


// Positionnement de celle-ci sur le lanceur 
bullet.transform.position = 
new Vector3 (transform.position.x, transform.position.y); 


return; 


E 


2.1 


Chapitre 5 
Interactions avec l'utilisateur 


Présentation générale 


Les périphériques de saisie classiques tels que le clavier, la souris, les manettes 
de jeu, sont pris en charge nativement par Unity. En plus de ces contrôleurs, 
les écrans tactiles ainsi que les différents détecteurs de mouvement des télé- 
phones mobiles sont accessibles. Unity permet également d'accéder au micro- 
phone et à la caméra pour récupérer des données audio et vidéo. 


. Prise en charge par défaut 


Le gestionnaire de commande 


L'éditeur propose un menu permettant de configurer les commandes par 
défaut, accessible via le menu Edit - Project Settings - Input. L'interface 
permet de définir des axes virtuels (virtual axes) qui seront liés aux boutons de 
votre périphérique. Ces axes peuvent être de différentes natures comme l'axe 
vertical, créé par défaut, permettant de faire avancer ou reculer le joueur, et lié 
aux touches [Flèche haut] et [Flèche bas]. 


Il est tout à fait possible de créer ses propres axes virtuels en les ajoutant dans 
la liste, d'en supprimer ou de modifier les axes existants. 
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Dans chaque projet nouvellement créé, des axes sont créés par défaut : 
— Les axes Horizontal et Vertical sont liés aux touches Z, Q, S et D ainsi que 
les flèches haut, bas, gauche et droite. 


— Les axes Fire1, Fire2, Fire3 sont liés aux touches [Ctrl], [Alt] et [Shift]. Ces 
sont les touches les plus fréquemment utilisées dans des jeux de tir. 

— Les axes Mouse X et Mouse Y sont liés aux déplacements de la souris sur 
les axes X et Y. 


— Les axes Window Shake X et Window Shake Y sont liés aux déplace- 
ments de la fenêtre. 


2.2 Propriétés d'un axe virtuel 


L'axe virtuel peut s'interfacer avec de nombreux types de périphériques : cla- 

vier, souris, manette, joystick, etc. Voici les propriétés qui le définissent : 

— Name : définit le nom de l'axe afin de l'utiliser à partir d'un script personna- 
lisé. 

— Descriptive Name : définit le nom à afficher dans la fenêtre de configura- 
tion ; utilisée dans un jeu de type PC pour la valeur positive de l'axe. 


- Descriptive Negative Name : définit le nom à afficher dans la fenêtre de 
configuration ; utilisée dans un jeu de type PC pour la valeur négative de 
l'axe. 


- Negative Button : définit le bouton à utiliser pour aller dans la direction 
opposée (négative) de l'axe. 

— Positive Button : définit le bouton à utiliser pour aller dans la direction 
(positive) de l'axe. 

— Alt Negative Button : définit le bouton alternatif à utiliser pour aller dans 
la direction opposée (négative) de l'axe. 


— Alt Positive Button : définit le bouton alternatif à utiliser pour aller dans 
la direction (positive) de l'axe. 


— Gravity : définit la vitesse (en unités par seconde) à laquelle l'axe revient sur 
sa position neutre lorsqu'aucune touche n'est appuyée. 
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— Dead : définit la taille de la zone morte (dead zone). Toutes les valeurs de 
l'axe entrant dans cette zone sont considérées comme neutre. 


— Sensitivity : définit la vitesse (en unités par seconde) à laquelle l'axe se 
déplace vers sa destination cible. 


— Snap: l'activation de cette option permet de réinitialiser l'axe à zéro lors de 
l'utilisation d'une commande dans la direction opposée. 


— Invert : l'activation de cette option permet d'inverser la direction de l'axe. 
La direction positive devient négative et inversement. 


— Type : définit le type d'entrée utilisé pour contrôler l'axe. 
— Axis : définit l'axe du périphérique utilisé pour contrôler l'axe. 


— Joy Num : définit le joystick utilisé pour contrôler l'axe. 


Utilisation dans un script personnalisé 


La classe Input 


Présentation 


Pour manipuler un axe à partir d'un script, nous allons utiliser la classe Input 
qui regroupe les fonctions et propriétés utiles à l'utilisation des inputs (entrées 
de périphérique). 


Si votre jeu contient une notion de déplacement, comme le fait de pouvoir 
faire avancer votre joueur ou une voiture que l'on conduit, il est recommandé 
d'utiliser les axes virtuels. Comme les axes sont facilement configurables et 
prévus pour ce genre de comportement, ils permettent une fluidité d'utilisa- 
tion comparé à la récupération de l'événement d'appui sur une touche pour le 
traiter soi-même. 


Sur les téléphones mobiles, de nouveaux comportements sont disponibles 
grâce à l'apport de l'écran tactile. Il est donc possible de suivre l'appui d'un ou 
plusieurs doigts sur l'écran et ce, simultanément. Il est possible d'accéder aux 
données de chacun des doigts appuyant sur l'écran lors de la dernière frame. 
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De même, l'accéléromètre permet de connaître l'orientation actuelle du télé- 
phone par rapport au sol ainsi que tous les changements de position. Ces don- 
nées sont représentées selon trois axes dans un repère tridimensionnel. Grâce 
à l'accéléromètre, Unity extrait aussi l'orientation du téléphone, mode portrait 
ou mode paysage, ce qui peut être particulièrement intéressant si l'on veut 
modifier l'affichage en fonction. 


Les propriétés 


La classe expose différentes propriétés permettant notamment de récupérer 
des informations sur les actions de l'utilisateur. 


Le premier groupe rassemble les propriétés relatives à l'accélération mesurée 
par l'accéléromètre : 


— acceleration: retourne la dernière mesure tridimensionnelle d'accéléra- 
tion de l'appareil. 


- accelerationEvent Count :le nombre d'accélérations mesurées pendant 
la dernière frame. 


— accelerationEvents : retourne la liste des accélérations mesurées 
pendant la dernière frame. 


On retrouve de la même façon, des informations dépendant directement du 
gyroscope ainsi que du GPS : 


— compass : retourne un objet Compass contenant des informations relatives 
au compas. 


- compensateSensors : détermine si les données du capteur doivent 
prendre en compte l'orientation de l'appareil. 


- deviceOrientation: retourne l'orientation courante de l'appareil. 


— gyro : retourne un objet Gyroscope contenant des informations relatives 
au gyroscope. 


— location : retourne un objet LocationService contenant des infor- 
mations relatives à la géolocalisation. 
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La classe Input prend aussi en compte tout ce qui touche aux IME (Input 
Method Editor). Les IME sont des programmes permettant aux utilisateurs 
d'entrer des caractères ou des symboles que ne fournit pas l'appareil native- 
ment. Cette méthode est notamment très utilisée pour les langues telles que 
le chinois, le japonais. 


- compositionCursorPos : retourne ou définit la position du texte actuel 
qui est utilisée par les IME pour ouvrir la fenêtre d'aide à la saisie. 


- compositionString : retourne ou définit la combinaison de texte de 
l'IME actuellement tapée par l'utilisateur. 


— imeCompositionMode : active ou désactive les combinaisons de texte 
IME. 


— imelsSelected: retourne si le joueur utilise un clavier configuré pour la 
combinaison de texte IME. 

Les propriétés liées au clavier : 

— inputString: retourne le texte entré au clavier pour la frame courante. 

- anyKey : détermine si une touche ou un bouton est actuellement enfoncé. 


— anyKeyDown : détermine la première fois qu'une touche ou un bouton est 
enfoncé. l'ant que tous les boutons n'ont pas été relâchés, retourne false. 


Les propriétés liées à la souris : 

— mousePosit ion : retourne les coordonnées de la souris (en pixels). 

- mouseScrollDelta : retourne le delta de défilement de la molette de la 
souris. 

Les propriétés liées au tactile : 

- multiTouchEnabled : retourne si le système permet la gestion des 
entrées tactiles multiples. 


— simulateMouseWithTouches : active ou désactive la simulation 
d'action à la souris grâce aux entrées tactiles. 


— touchCount : retourne le nombre d'entrées tactiles actives de la frame 
courante. 
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— touches : retourne une liste d'objets Touch définissant le statut des 
entrées tactiles lors de la dernière frame. 


— touchSupported : retourne si le système permet la gestion du tactile. 


Les méthodes 


À l'instar des propriétés, on peut classer de la même manière les méthodes par 
type d'entrée. 


La méthode relative à l'accéléromètre : 


— GetAccelerationEvent : retourne l'accélération obtenue lors de la 
dernière frame. 


Les méthodes relatives aux axes virtuels : 


— GetAxis : retourne la valeur de l'axe virtuel grâce à son nom. 


— GetAxisRaw : retourne la valeur de l'axe virtuel grâce à son nom, sans que 
le filtre de lissage de la valeur ne soit appliqué. 


- ResetInputAxes : remet à zéro l'ensemble des entrées de l'utilisateur, 
axes et boutons, pour une frame. 


— GetButton : retourne si le bouton virtuel spécifié par son nom est actuel- 
lement enfoncé. 


— GetButtonDown : retourne si le bouton virtuel, spécifié par son nom, a été 
enfoncé pendant la frame courante. 


— GetButtonUp : retourne si le bouton virtuel, spécifié par son nom, a été 
relâché pendant la frame courante. 


Les méthodes relatives aux joysticks : 


— GetJoystickNames : retourne la liste des noms des joysticks connectés. 


— IsJoystickPreconfigured : retourne si un joystick particulier a été 
préconfiguré par Unity (seulement sur Linux). 


Les méthodes relatives au clavier : 


— GetKey : retourne si le joueur maintient appuyée une touche spécifique. 
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— GetKeyDown : retourne si le joueur a appuyé sur une touche spécifique 
durant la frame courante. 


— GetKeyUp : retourne si le joueur a relâché une touche spécifique durant la 
frame courante. 


Les méthodes relatives à la souris : 


- GetMouseButton : retourne si un bouton spécifique de la souris est 
actuellement enfoncé. 


— GetMouseButtonDown : retourne si le joueur a appuyé sur un bouton 
spécifique de la souris durant la frame courante. 


— GetMouseButtonUp : retourne si le joueur a relâché un bouton spécifique 
de la souris durant la frame courante. 


La méthode relative au tactile : 


— Get Touch : retourne un objet Touch définissant le statut d'une entrée 
tactile spécifique. 


Exemples d'utilisation du clavier 


Récupérer une entrée au clavier 


Nous allons mettre en place un script permettant de réagir à une entrée au 
clavier. Dans notre exemple, on augmentera la taille du GameObject lorsque 
le joueur appuiera sur la touche [Espace]. 


using UnityEngine; 


public class KeyboardInteraction : MonoBehaviour 


{ 


private Vector3 _originTransform; 


void Start () 


{ 
// On sauvegarde la taille d'origine 
_originTransform = transform.localScale; 


} 


void Update () 


{ 


if (Input.GetKey (KeyCode.Space)) 
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// On double la taille lors de l'appui sur la touche Espace 
transform.localScale = _originTransform * 2; 


} 


else 


{ 


// sinon, on remet la taille d'origine 
transform.localScale = originTransform; 


2.3.3 Exemples d'utilisation de la souris 


Récupérer une entrée à la souris 


Nous allons mettre en place un script permettant d'interagir avec la souris. Dans 
notre exemple, on fera tourner notre GameObject dans le sens horaire lorsque 
le joueur fera un clic gauche et dans le sens contraire lors d'un clic droit. 


using UnityEngine; 


public class Mouselnteraction : MonoBehaviour 
void Update () 
{ 
bool isLeftMouse = Input.GetMouseButton (0); 
bool isRightMouse = Input .GetMouseButton (1); 


if (isLeftMouse && !lisRightMouse) 
// On tourne dans le sens horaire 
// si le joueur fait un clic gauche 
transform.RotateAround(Vector3.zero, Vector3.up, 20 * 
Time.deltaTime) ; 


} 


else if (isRightMouse && l!lisLeftMouse) 
// On tourne dans le sens anti-horaire si le joueur 
// fait un clic droit 
transform.RotateAround(Vector3.zero, Vector3.up, 
-20 * Time.deltaTime) ; 
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interagir entre la souris et les GameObjectis 


Dans de nombreux jeux, il peut être utile de pouvoir sélectionner un objet de 
la scène lorsque l'on clique dessus. Pour ce faire, nous allons utiliser la tech- 
nique de lancer de rayon (raycasting) afin de détecter les objets entrant en col- 
lision avec un rayon fictif. Ce rayon sera créé à partir de deux points : la 
position de la caméra et la position de la souris à l'écran. Le moteur physique, 
via la classe Physics, permet de créer facilement ce vecteur en utilisant les 
bons repères. Dans notre cas, on utilise la méthode Raycast qui nous 
retourne un objet de type RaycastHit, contenant le premier GameObject de 
la scène ayant été touché par le rayon. 


Chaque GameObject touché et possédant un composant de type MeshRen- 
derer (comme un Cube) verra sa couleur passer au rouge. 


using UnityEngine; 


public class MouseRaycast : MonoBehaviour 


{ 


public Camera CurrentCamera; 


void Start () 


{ 


// Si aucune caméra n'est définie, on essaie de récupérer 
// la caméra principale 
if (CurrentCamera == null) 


{ 
} 


CurrentCamera = Camera.main; 


} 


void Update () 
{ 
// Si le joueur fait un clic gauche 
// et qu'une caméra est selectionnée 
if (Input.GetMouseButtonDown(0) && CurrentCamera != null) 
{ 
// L'objet qui sera utilisé pour obtenir les informations 
// sur le GameObject détecté lors de la collision 
RaycastHit hit; 


// Création du rayon qui sera utilisé pour détecter 
// la collision avec les objets de la scène. 

// Le rayon part de la caméra à la position actuelle 
// de la souris 


Ray ray = CurrentCamera.ScreenPointToRay (Input .mousePosition) ; 
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// On lance le rayon, grâce au moteur physique, pour détecter 
// la première collision avec un objet 
if (Physics.Raycast (ray, out hit, 500)) 


{ 
// Si l'objet possède un composant de type MeshRenderer 
MeshRenderer meshRenderer = hit.transform.GetComponent 
<MeshRenderer»> () ; 
if (meshRenderer != null) 


{ 
// On change la couleur du matériau en rouge 
hit .transform.GetComponent<MeshRenderer> () 
.material.color = Color.red; 


Remarque 


Afin de connaître la liste de tous les éléments touchés par un rayon lors d'une 
opération de raycasting, il faut utiliser la méthode RaycastAl1. 


2.3.4 Exemples d'utilisation du tactile 


Récupérer une entrée tactile 


Dans cet exemple, on utilise la propriété touchCount pour savoir si une 
entrée tactile est détectée puis la méthode Get Touch afin de récupérer des 
informations sur celle-ci. À chaque touch repérée, on ajoute un nouvel objet 
dans la scène à la position actuelle du doigt. 


using UnityEngine; 


public class Touchlinteraction : MonoBehaviour 


{ 


public Transform PrefabTolnsertInScene; 


void Update () 

{ 
// Si aucun prefab n'est associé, rien ne se passe 
if (PrefabTolnsertInScene == null) 


{ 


return; 
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} 


// Si au moins un doigt est détecté 

if (Input.touchCount > 0) 
// On récupère les informations du premier doigt 
Touch currentTouch = Input.GetTouch (0); 


// Si le doigt vient juste d'être détecté 
if (currentTouch.phase == TouchPhase.Began) 
{ 
// On ajoute un nouvel objet dans la scène 
// à une position aléatoire 
var position = new Vector3(Random.Range(-10, 10), 
Random.Range(-10, 10), Random.Range(-10, 10)); 
Instantiate (PrefabTolnsertInScene, position, 
Quaternion.identity); 


} 


interagir entre les entrées tactiles et les GameObjects 


En repartant du script utilisé dans la section Interagir entre la souris et les 
GameObjects de ce chapitre, nous allons modifier le script afin de pouvoir 
agrandir la taille de l'objet sélectionné grâce à une gestuelle spécifique. La ges- 
tuelle consiste à poser deux doigts sur l'écran et de les rapprocher (afin de dimi- 
nuer la taille) ou de les écarter (afin d'agrandir la taille). 


Dans notre cas, la gestion des deux gestes va être simplifiée car on ne se basera 
que sur la distance entre les deux doigts pour savoir s'il faut augmenter ou 
réduire la taille de l'objet. 


using UnityEngine; 
public class TouchGesture : MonoBehaviour 
{ 

public Camera CurrentCamera; 

private Transform selectedObject; 


private float distance; 


private bool _isFirstTouchEnable; 
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private bool _isSecondTouchEnable; 
private bool _isGestureActive; 


private Vector3 scale; 
void Start () 
{ 
if (CurrentCamera == null) 


{ 
} 


CurrentCamera = Camera.main; 


} 


void Update () 


{ 


if (CurrentCamera == null) 
{ 
return; 
} 
HandleSelection(); 


HandleGesture () ; 


} 


private void HandleSelection() 
{ 
// Si le joueur touche l'écran 
if (Input.touchCount > 0) 
{ 
// L'objet qui sera utilisé pour obtenir les informations 
// sur le GameObject détecté lors de la collision 
RaycastHit hit; 


// Création du rayon qui sera utilisé pour détecter 

// la collision avec les objets de la scène. 

// Le rayon part de la caméra à la position 

// actuelle du doigt 

Ray ray = CurrentCamera.ScreenPointToRay (Input .GetTouch (0) 
.position) ; 


// On lance le rayon, grâce au moteur physique, 
// pour détecter la première collision avec un objet 
if (Physics.Raycast (ray, out hit, 500)) 


{ 


_selectedObject = hit.transform; 


var meshRenderer = _selectedObject.GetComponent 
<MeshRenderer»> () ; 
if (meshRenderer != null) 
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{ 
meshRenderer.material.color = Color.red; 
} 
} 
} 
} 
private void HandleGesture() 
{ 
if (Input.touchCount > 1 && selectedObject != null) 
{ 


// Récupération des informations des deux doigts 
Touch firstTouch = Input.GetTouch(0); 
Touch secondTouch = Input.GetTouch (1); 


if (!_isFirstTouchEnable || !_isSecondTouchEnable) 
{ 
if (firstTouch.phase == TouchPhase.Began 
|| firstTouch.phase == TouchPhase.Moved 
|| firstTouch.phase -- TouchPhase.Stationary) 


{ 
} 


_isFirstTouchEnable = true; 


if (secondTouch.phase == TouchPhase.Began 
|| secondTouch.phase == TouchPhase.Moved 
|| secondTouch.phase == TouchPhase.Stationary) 
{ 
_isSecondTouchEnable = true; 
} 
} 
// Un des doigts a-t-il été levé ? 
if (firstTouch.phase == TouchPhase.Ended) 
{ 
_isFirstTouchEnable = false; 
} 
if (secondTouch.phase == TouchPhase.Ended) 
{ 


_isSecondTouchEnable = false; 


} 


// Si les deux doigts touchent l'écran 
if (_isFirstTouchEnable && _isSecondTouchEnable) 
{ 
if (!_isGestureActive) 
{ 
_scale = _selectedObject.localScale; 
_distance = Vector3.Distance(firstTouch.position, 
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secondTouch.position) ; 
_isGestureActive = true; 


} 


// Calcul de la distance entre les deux doigts 
float currentDistance = Vector3.Distance (firstTouch. 
position, secondTouch.position) ; 


// Modification de la taille de l'objet 

// en fonction de la distance 

_selectedObject.localScale = _scale * (1 + 
((currentDistance - distance) / 100)); 


_isGestureActive = false; 


Remarque 


La méthode HandleGesture Vérifie tout d'abord si le nombre de doigts 
détecté est supérieur à 1 et si un objet est sélectionné. Si c'est le cas, on récur- 
père les informations relatives aux deux premiers doigts détectés (en mouve- 
ment, statique, terminé..). Si les deux doigts touchent l'écran, alors on 
agrandit ou diminue la taille de l’objet en fonction de la distance entre les 
deux doigts. 


Traçabilité des entrées tactiles 


On a vu que les entrées tactiles multiples sont possibles ce qui peut poser des 
problèmes si l'on veut être sûr que la première entrée de la liste soit toujours 
le même doigt et non pas un autre. En fonction des plateformes, des compor- 
tements imprévisibles sont à prévoir et il ne faut pas se fier uniquement à 
l'ordre des entrées dans la propriété touches dans la logique de ses scripts. 
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Pour pallier ce problème, Unity met à disposition un identifiant unique, 
fingerId, présent dans la classe Touch, pour chaque doigt ce qui permet de 
retrouver à coup sûr le bon doigt dans la liste. Il est donc inutile de créer son 
propre système d'identification des entrées d'une frame à l'autre. 


using UnityEngine; 


public class Touchldentification : MonoBehaviour 


{ 


private int firstTouchldentifier; 


void Update () 


{ 


Touch firstTouch; 


// Si on a au moins une entrée tactile 
if (Input.touchCount >= 1) 
{ 
if (_firstTouchldentifier >= 0) 
{ 
// Si on a une entrée tactile sauvegardée, on essaie 
// de la retrouver 
bool hasFoundATouch = false; 
foreach (var touch in Input.touches) 


{ 
if (touch.fingerId == firstTouchldentifier) 
{ 
hasFoundATouch = true; 
firstTouch = touch; 
break; 


} 


// L'entrée n'a pas été retrouvée donc on supprime 
// l'identifiant sauvegardé 
if (!hasFoundATouch) 


{ 


_firstTouchidentifier = -l; 


else 


// C'est la première entrée, on sauvegarde 

// donc son identifiant pour le retrouver plus tard 
firstTouch = Input .GetTouch (0); 
_firstTouchlidentifier = firstTouch.fingerld; 
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_firstTouchldentifier = -1l; 


} 


// TODO : Faire quelque chose avec cette entrée 


Utilisation du microphone et de la webcam 


Utilisation du micro 


Présentation 


Sur PC comme sur mobile, il est possible d'utiliser un microphone pour enre- 
gistrer des sons et les intégrer dans le jeu. Pour ce faire, Unity met à disposition 
la classe Microphone permettant d'obtenir la liste des micros disponibles 
afin d'interagir avec eux. 


La classe Microphone 


Elle ne comprend qu'une seule et unique propriété, devices, permettant de 
lister l'ensemble des micros connectés et disponible. 


Les méthodes disponibles permettent de lancer un enregistrement ou d'obte- 
nir des informations sur un microphone : 


— GetDeviceCaps : permet d'obtenir la fréquence minimale et maximale de 
l'appareil. En ne renseignant pas de nom pour le micro, le microphone par 
défaut sera sélectionné. Si les valeurs de retours sont égales à zéro, l'appareil 
prend en charge toutes les fréquences. 


— GetPosition : permet de récupérer la position actuelle dans l'échantillon 
en cours d'enregistrement. 


— IsRecording: permet de savoir si le microphone est en cours d'enregistre- 
ment. 
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— Start : permet de démarrer un enregistrement. Retourne un objet de type 
AudioClip pouvant être lu dans le jeu. 


— End : permet d'arrêter un enregistrement. 


HRemarque 


Dans une application utilisant le Web Player, il est nécessaire de demander 
l'autorisation afin d'utiliser le micro de l'utilisateur. Pour cela, il faut appeler la 
fonction Application.RequestUserAuthorization avant l'utilisation d'une 
méthode de la classe Microphone. 


Exemple d'utilisation 


Dans notre exemple, nous allons utiliser l'ensemble des méthodes et proprié- 
tés de la classe Microphone dans le but d'enregistrer notre voix afin de la 
rejouer avec 100 millisecondes de latence. Il faudra ajouter un composant de 
type AudioSource à l'objet contentant ce script afin de pouvoir lire notre 
enregistrement. 


using System; 
using UnityEngine; 


public class MicrophoneRecorder : MonoBehaviour 
private string microphoneName; 
private AudioClip voiceAudioClip; 
private int _frequency; 
private AudioSource _audioSource; 


void Start () 

{ 
// Si aucune source audio n'est trouvée, on ne fait rien 
_audioSource = GetComponent<AudioSource» (); 
if (_audioSource == null) 


{ 
} 


return; 


// Si aucun micro n'est détecté, on ne fait rien 
if (Microphone.devices.Length < 1) 


{ 
} 


return; 


// Récupération du nom du premier micro de la liste 
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_microphoneName = Microphone.devices [0]; 


// Récupération des bornes des fréquences 

int minFrequency; 

int maxFrequency; 

Microphone .GetDeviceCaps(_microphoneName, out minFrequency, 
out maxFrequency) ; 


if (minFrequency == 0 && maxFrequency == 0) 


{ 


_frequency = 44100; 


_frequency = maxFrequency; 


} 


// Lancement de l'enregistrement 
_voiceAudioClip = Microphone.Start(_ microphoneName, false, 10, 
_frequency) ; 


void Update () 


{ 


// Le microphone et la source audio doivent être spécifiés 
if (string.IsNullOrEmpty(_microphoneName) || _audioSource == null) 


{ 
} 


return; 


// Si le micro est en train d'enregistrer 
if (Microphone.IsRecording(_microphoneName) ) 
{ 
// Récupération de la position dans le flux audio 
int position = Microphone.GetPosition(_microphoneName) ; 


// Si on a dépassé les 100 ms de latence et que la lecture 
// de l'enregistrement n'est pas encore lancée 
if (position >= 100 && ! audioSource.isPlaying) 
{ 
// Lecture de l'enregistrement audio grâce 
// au composant AudioSource 
_audioSource.clip = voiceAudioClip; 
_audioSource.volume = 1; 
_audioSource.Play(); 
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Remarque 


Dans l'exemple, on affecte la valeur 44100 à la variable _frequency. Cette 
valeur est le standard utilisé pour les CD et plus généralement pour le digital. 
Elle s'exprime en Hertz (Hz) et définit le nombre d'échantillons joués chaque 
seconde. 


Utilisation de la webcam 


Présentation 


L'utilisation de la webcam est intégrée de façon native dans Unity afin de 
permettre au développeur de créer une interaction riche avec le joueur. Le jeu 
pourra donc afficher ce que capture la caméra pour y appliquer des filtres ou 
y rajouter du contenu virtuel. Pour obtenir ce que capture la webcam, il faut 
utiliser la classe WebCamTexture. 


La classe WebCamïTexture 


De la même manière que la classe Microphone, cette classe comprend une 
propriété statique devices permettant de lister l'ensemble des caméras 
connectées et disponibles. La classe dérivant de la classe Texture, elle hérite 
donc de ses propriétés et méthodes. 


Voici la liste des propriétés qui la composent : 


— deviceName : permet de définir le nom de la caméra à utiliser. 


— didUpdateThisFrame : permet de savoir si le buffer vidéo a été mise à 
jour lors de cette frame. 


— isPlaying : permet de savoir si la caméra est en train de fonctionner ou 
non. 


— requestedFPS : permet de faire une demande de modification du frame- 
rate (en fps) de la caméra. 


— requestedHeight : permet de faire une demande de modification de la 
hauteur de la caméra. 


— requestedWidth : permet de faire une demande de modification de la 
largeur de la caméra. 
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- videoRotationAngle : retourne l'angle en degrés qui peut être utilisé sur 
un objet pour que le rendu soit affiché dans la bonne orientation. 


- videoVerticallyMirrored : permet de savoir si la vidéo est retournée 
verticalement. 


Au niveau des méthodes, on retrouve deux groupes. Le premier permet de 
gérer la marche et l'arrêt de la webcam : 


- Pause : met en pause la caméra. 
— Play : démarre la caméra. 
— Stop : arrête la caméra. 


Le second permet d'obtenir des informations sur le rendu en cours : 


- GetPixel(int x, int y) : permet de récupérer la couleur (Color) 
d'un pixel spécifique dans l'image. 


- GetPixels(int x, int y, int width, int height) : permet de 
récupérer les couleurs (Color []) d'un groupe de pixels dans l'image. 


— GetPixels32 : permet de récupérer la totalité des couleurs de l'image. 


Exemple d'utilisation 


Dans cet exemple, nous allons afficher le rendu de la webcam sur un cube que 
nous aurons ajouté dans la scène ainsi qu'une sphère qui prendra comme 
couleur, la couleur moyenne du rendu de la caméra. 


Créez une nouvelle scène. 


Ajoutez un objet de type Cube, pour le rendu de la caméra, et un de type 
Sphere, pour le rendu de la couleur moyenne. 


DAjoutez une lumière directionnelle afin d'éclairer la scène. 
Créez le script suivant et ajoutez-le au Cube : 

using UnityEngine; 

public class WebcamViewer : MonoBehaviour 

{ 


public Renderer AverageRenderer; 


private WebCamTexture webcamTexture; 
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private Renderer _renderer; 


void Start () 


{ 


} 


_renderer = GetComponent<Renderer»> () ; 
// Si aucune caméra n'est détectée, on ne fait rien 
if (_renderer == null 
|| WebCamTexture.devices.Length <= 0) 
{ 


} 


return; 


// Création d'une nouvelle texture liée à la caméra 
_webcamTexture = new WebCamTexture () ; 
_renderer.material.mainTexture = _webcamTexture; 
_webcamTexture.Play(); 


void Update () 


{ 


// Si le composant Renderer n'est pas défini, on ne fait rien 


if (AverageRenderer == null 

|| _webcamTexture == null) 
{ 

return; 


} 


float alpha = 0; 
float red = 0; 
float green = 0; 


float blue = 0; 


// Récupération des l'ensemble des couleurs de l'image générée 
// Valeur entre 0 et 255 sur les 4 canaux 
Color32[] pixels = webcamTexture.GetPixels32(); 


foreach (var pixel in pixels) 
{ 

alpha += pixel.a; 

red += pixel.r; 

green += pixel.g; 

blue += pixel.b; 


} 


// Calcul de la couleur moyenne de l'image 
// Valeur entre 0 et 1 sur les 4 canaux 
Color averageColor = new Color (); 
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averageColor.a = (alpha / pixels.Length) / 255; 
averageColor.r = (red / pixels.Length) / 255; 

averageColor.g = (green / pixels.Length) / 255; 
averageColor.b = (blue / pixels.Length) / 255; 


AverageRenderer.material.color = averageColor; 


} 


Sélectionnez la Sphere et changez le type de matériau dans la fenêtre 
Inspector en Sprites-Default. 


DLiez la Sphere au script précédemment créé via la propriété Average 
Renderer. 
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1. La caméra 


1.1 Présentation 


La caméra sert à capturer et à afficher le monde au joueur. Cet élément est un 
objet essentiel d'une scène et doit être défini avec précaution car c'est lui qui 
est en première ligne sur l'aspect général de votre jeu. Le nombre de caméras 
n'est pas limité mais les performances peuvent baisser si ce nombre devient 
important. Elles n'ont pas d'ordre de rendu défini et peuvent afficher l'intégra- 
lité de la scène ou seulement une partie. 


1.2 Paramétrage de l'affichage 


Dans l'Inspector on retrouve de nombreuses propriétés permettant de modeler 
la caméra selon ses besoins. 


1.2.1 Affichage des objets 


— Clear Flags : cette propriété permet de paramétrer l'affichage des parties de 
l'écran sans affichage. Cela est utile lors de l'utilisation de plusieurs caméras 
en même temps afin d'afficher un type d'objet sur la première caméra et un 
autre type d'objet sur la seconde caméra. 
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Le principe est simple, chaque caméra enregistre les informations de couleur 
et de profondeur quand il rend la vue. Les parties de l'écran n'étant pas 
renseignées, sans information de couleur donc, afficheront par défaut une 
Skybox. Lors de l'utilisation de plusieurs caméras, chacune d'entre elles 
enregistre ses propres informations en mémoire pour ensuite les combiner 
lors de la génération de la vue. 

— Skybox : c'est la valeur par défaut. Chaque portion vide de l'écran affiche- 
ra la Skybox attachée à celle-ci. 

— Solid Color : chaque portion vide de l'écran affichera la couleur définie 
dans la propriété Background. 

— Depth Only : cette valeur permet de rendre un objet sans prendre en 
compte sa position dans l'espace et donc sa profondeur. Elle est particuliè- 
rement utilisée dans les FPS (First Person Shooter) afin d'afficher une arme 
par exemple. 

— Don't Clear : cette valeur un peu spéciale est rarement utilisée sans être 
associée à un shader. Elle fait en sorte de ne pas effacer les informations 
du buffer de rendu de la vue ce qui fait qu'à chaque cycle, le rendu de la 
vue se fait par-dessus l'ancien. 


— Background : définit la couleur à utiliser pour le rendu des zones de l'écran 
vide une fois tous les éléments de la scène affichés et sans qu'aucune Skybox 
ne soit paramétrée. 


— Culling Mask : définit les layers à prendre en compte ou non, lors du rendu 
de la caméra. Les objets de la scène peuvent être affectés à un layer via 
l'Inspector. 


1.2.2 Vision et projection 


— Projection : permet de changer la perspective des objets de la scène. 
— Perspective : la caméra affichera les objets de la scène en gardant la pers- 
pective. 
— Orthographic : la caméra affichera les objets de la scène uniformément 
sans prendre en compte la perspective. 


— Size : quand la propriété Orthographic est sélectionnée, définit la taille de 
la fenêtre de la caméra. 
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— Field of view : quand la propriété Perspective est sélectionnée, définit la 
taille de l'angle de vue de la caméra, en dégrés selon l'axe Y. 


— Clipping Planes : définit la distance de début et de fin de rendu de la camé- 
ra. Les objets en dehors de cette zone seront ignorés. 
— Near : le point le plus proche par rapport à la caméra où l'affichage se 
produira. 
— Far : le point Le plus loin par rapport à la caméra où l'affichage se produira. 


- Normalized View Port Rect : définit la position et la taille où sera affi- 
ché le rendu de la caméra à sur l'écran. Les valeurs sont définies en Screen 
Coordinates (coordonnées d'écran) avec des valeurs allant de 0 à 1. 


— X : définit la position horizontale où la caméra sera rendue à l'écran. 
— Ÿ : définit la position verticale où la caméra sera rendue à l'écran. 
— W : définit la largeur de la caméra à l'écran. 
- H : définit la hauteur de la caméra à l'écran. 
— Depth : définit la position de la caméra dans l'ordre d'affichage. Les caméras 


ayant une valeur élevée seront affichées au-dessus des caméras ayant. une 
valeur basse. 


— Rendering Path : liste des options afin de définir la méthode de rendu qui 
sera utilisée par la caméra. 

— Use Player Settings : la caméra utilisera les Rendering Path définis 
dans les Player Settings. 

— Vertex Lit : tous les objets de la caméra seront rendus comme des objets 
Vertex-Lit. 

— Forward : tous les objets seront rendus avec seulement une passe par 
matériaux. 

- Deferred Lighting : tous les objets seront rendus une seule fois sans 
lumière puis le rendu de l'ensemble des objets avec la lumière sera fait à la 
fin du cycle de rendu. 

— Target Texture : définit une Render Texture (texture de rendu) qui 
contient le rendu de la vue de la caméra. En renseignant cette texture, le 
calcul du rendu de la caméra sera désactivé. 


— HDR : active le rendu High Dynamic Range pour la caméra. 


184 Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


1.3 La vue Frustum 


1.3.1 Définition 


Le Frustum (tronc) désigne un solide, souvent de type pyramidal ou cylin- 
drique, délimité par deux plans parallèles. Dans Unity, cela se prête parfaite- 
ment pour définir le champ de vision de la caméra prenant en compte la 
perspective des objets. 


1.3.2 Expérimentations 


Pour bien comprendre le principe, nous allons faire trois expériences : 


1  Placez-vous devant un écran et positionnez les yeux au centre de celui-ci. 
Positionnez maintenant un stylo perpendiculairement à l'écran et au 
centre de celui-ci. Qu'est-ce que l'on remarque ? On ne voit qu'une partie 
du stylo, son dos, qui représente un cercle. 


2 Toujours devant l'écran, positionnez les yeux au centre de celui-ci. Placez 
le stylo perpendiculairement à l'écran et au centre de celui-ci et déplacez- 
le de quelques centimètres vers le haut. Qu'est-ce que l'on remarque ? On 
voit toujours le dos du stylo mais aussi son corps. Le tout forme une sorte 
de trapèze. 


3 Inclinez maintenant le stylo de façon à ce que l'extrémité la plus proche 
de l'écran remonte vers le haut de l'écran jusqu'à ne plus voir qu'un cercle 
(comme dans l'expérience 1). 


| Expérience 1 Expérience 2 Expérience 3 | 
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Le but de cette expérience est de montrer que pour tout point de l'image de 
rendu de la caméra correspond une ligne dans l'espace et qu'un seul point de 
cette ligne est visible dans cette image. Tout ce qui est derrière cette position 
sur cette ligne n'est pas affiché. 


1.3.3 Limites d'affichage 


Les bords extérieurs de l'image sont définis par les lignes divergentes qui cor- 
respondent aux coins de l'image. Si les lignes passant derrière la caméra étaient 
tracées, elles convergeraient toutes vers un seul point. Dans Unity, on appelle 
ce point le centre de perceptive et il est situé exactement aux coordonnées du 
Transform de la caméra. L'angle créé par les lignes partant des centres supé- 
rieurs et inférieurs de l'écran jusqu'au centre de perspective est appelé Field Of 
View (champ de vision), souvent abrégé FOV. 


Arrière-plan 


: Premier plan 
Fe 


En 


Centre de perspective 


1.3.4 Différence entre la vue perspective el la vue orthographique 


Afin de comprendre la différence entre les deux modes de projection, nous 
allons créer deux scènes avec les différentes vues possibles. 


Création d'une scène ayant une caméra prenant 
en compte la perspective 


Dans le menu File, créez une nouvelle scène en cliquant sur le sous-menu 
New Scene. 


186 Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Dans la fenêtre Hierarchy, sélectionnez l'objet Main Camera et suppri- 
mez-le. Cliquez ensuite sur Create - Create Empty. 


Dans la fenêtre Inspector, cliquez sur Add Component - Rendering - 
Camera. Dans le composant Camera nouvellement créé, renommez l'objet 
Perspective Camera. Modifiez les propriétés Projection en vue Perspec- 
tive, Clear Flags en Solid Color, Field Of View à 80 et Background avec 
votre couleur préférée. Modifiez la Position de la caméra en (0, 3, -5) et sa 
Rotation en (20, O, O). 


Dans la fenêtre Hierarchy, sélectionnez Create - 3D Object - Cube. 
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Dans la fenêtre Inspector du cube, vérifiez que les propriétés de Position 
sont bien renseignées à 0 et la Rotation selon l'axe Y à 60. 


Dans la fenêtre Hierarchy, sélectionnez l'objet Perspective Camera. 
Cliquez sur Create - Light - Directional Light. 


Create Empty 
Create Empty Child 
3D Object 

2D Object 


Point Light 
Spotlight 

Area Light 
Reflection Probe 
Light Probe Group 


Dans la fenêtre Inspector de la lumière, remettez à zéro ses propriétés 


Transform en cliquant sur l'icône E3 et choisissez l'option Reset. 
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| 6 Inspector 
M (Directional light 


Tag | Unragged +} Layer | Default 


Move to Front 

Move to Back 

Copy Component 

Paste Component As New 
Paste Component Values 
Reset Position 

Reset Rotation 

Reset Scale 


ae LTÉXTUPET 


Le rendu de cette scène montre bien un cube, la caméra prenant en compte la 
1 

profondeur lors de l'affichage de celui-ci, ce qui déforme un peu son aspect. 

Pour savoir si la perspective est prise en compte, on peut essayer de bouger la 

caméra : 


Sélectionnez l'objet Perspective Camera dans la fenêtre Scene. Cliquez 
sur l'axe Z (de couleur bleu) et faites-le bouger afin d'observer les change- 
ments sur le cube. 
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On voit bien le cube se reprocher/s'éloigner en se déformant plus ou moins 
selon la distance avec la caméra. La perspective est donc bien en place. 


Création d'une scène ayant une caméra 
en mode de projection orthographique 


Dans le menu File, créez une nouvelle scène en cliquant sur le sous-menu 
New Scene. 


Dans la fenêtre Hierarchy, sélectionnez l'objet Main Camera et suppri- 
mez-le. Cliquez ensuite sur Create - Create Empty. 


Dans la fenêtre Inspector, cliquez sur Add Component - Rendering - 
Camera. Dans le composant Camera nouvellement créé, renommez l'objet 
Orthographic Camera. Modifiez les propriétés Projection en vue Ortho- 
graphic, Clear Flags en Solid Color et Background avec votre couleur 


préférée. Modifiez la Position de la caméra en (0, 3, -5) et sa Rotation en 
(20, 0, O). 
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Dans la fenêtre Hierarchy, sélectionnez Create - 3D Object - Cube. 
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Dans la fenêtre Inspector du cube, vérifiez que les propriétés de Position 
soient bien renseignées à 0 et la Rotation selon l'axe Y à 60. 


Dans la fenêtre Hierarchy, sélectionnez l'objet Orthographic Camera. 
Cliquez sur Create - Light - Directional Light. 
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Dans la fenêtre Inspector de la lumière, remettez à zéro ses propriétés 


Transform en cliquant sur l'icône et choisissez l'option Reset. 


6 Inspector : . 
Er] M |Directional light LiStatic » 


Tag | Untagged +] Layer [Default 


Move to Front 
Move to Back 


Copy Component 

Paste Component As New 
Paste Component Values 
Reset Position 

Reset Rotation 


Reset Scale 


Nane LTÉXTIFE] 


De la même manière que l'exemple précédent, on va essayer de bouger la 
caméra : 


Sélectionnez l'objet Perspective Camera dans la fenêtre Scene. Cliquez 
sur l'axe Z (de couleur bleu) et faites le bouger afin d'observer les change- 
ments sur le cube. 
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Le cube ne se déforme d'aucune manière et on peut le voir monter et descendre 
invariablement. C'est donc bien une projection orthographique qui est rendue 
par notre caméra. 


Les lumières 


Présentation 


Les lumières prennent une place de choix dans la création d'un jeu vidéo. Elles 
font partie de la mise en place de l'ambiance générale que vous souhaitez 
donner à votre jeu. De plus, ce sont les lumières qui détermineront l'affichage, 
total ou partiel, ou l'emplacement des ombres des objets de la scène. 


Dans Unity, il existe quatre types de lumières : Point, Spot, Directional et 
Area. La version 5 introduit aussi un nouveau système appelé Global Illumina- 
tion (GT) permettant de gérer les lumières indirectes. 
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2.2 Paramétrage des lumières 


Dans l'Inspector on retrouve de nombreuses propriétés permettant de modeler 
la lumière selon ses besoins. 


— Type : définit le type de lumière utilisé parmi Point, Spot, Directional et 
Area. 


- Baking : permet de choisir si on doit utiliser un procédé de baking (voir 
remarque à la suite de cette liste) sur la lumière. En choisissant Baked, vous 
activez le baking sur la lumière. L'option Realtime permet de gérer le rendu 
en temps réel des objets non statiques que la Global Illumination soit utilisée 
ou non. Pour activer les deux options en même temps, choisissez le mode 
Mixed. 


— Range : définit la distance d'émission à partir du centre de l'objet. Unique- 
ment utilisable pour les lumières de type Point et Spot. 


- Spot Angle : définit l'angle, en degrés, à la base du cône. Plus l'angle est 
grand, plus le spot sera ouvert. Uniquement utilisable pour la lumière de 
type Spot. 


— Color : définit la couleur émise par la lumière. 


— Intensity : définit la luminosité de la lumière. Pour une lumière de type 
Point, Spot et Area cette valeur est de 1 par défaut tandis qu'elle est de 0,5 
pour une lumière Directional. 


— Bounce Intensity : définit la variation de l'intensité des lumières indirectes 
comme une lumière qui rebondit sur un objet. Ce paramètre est un multi- 
plicateur de la luminosité calculé par le système de Global Illumination. Les 
valeurs supérieures à 1 auront pour effet de rendre la lumière plus brillante 
et, inversement, les valeurs inférieures à 1 auront pour effet de rendre la lu- 
mière plus sombre. Cela peut être utile pour éclairer une pièce un peu trop 
sombre afin de voir plus de détails (une grotte par exemple). 


— Shadow Type : définit quel type d'ombre sera générée par la lumière. Hard 
Shadows permet de rendre une ombre de manière simple avec un niveau de 
détail acceptable dans la plupart des cas. Pour un rendu plus poussé et plus 
nette il faudra utiliser l'option Soft Shadows qui permet de générer une 
ombre plus complexe avec notamment, un meilleur antialiasing (lissage des 
contours). Dans le cas où aucune ombre n'est souhaitée, choisissez l'option 
No Shadows. 
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— Baked Shadow Radius : si l'option Soft Shadows est sélectionnée, per- 
met de définir la netteté sur les bords de l'ombre projetée par une lumière de 
type Point ou Spot. Les ombres projetées sont, en théorie, parfaitement 
lisses et nettes ce qui n'arrive jamais en réalité. 


— Baked Shadow Angle : si l'option Soft Shadows est sélectionnée, permet 
de définir la netteté sur les bords de l'ombre projeté par une lumière de type 
Directional. Les ombres parallèles sont, en théorie, parfaitement lisses et 
nettes ce qui n'arrive jamais en réalité. 


— Draw Halo : si elle est sélectionnée, cette option permet de générer un halo 
de lumière sphérique ayant un rayon équivalent à la valeur Range. 


— Flare : définit une référence à un objet Flare (éclat) qui sera rendu où est 
positionnée la lumière. 


- Render Mode : définit l'importance de la lumière dans la scène pour des 
questions de performance et de qualité. Par défaut, l'option Auto est sélec- 
tionnée, ce qui laisse la main au système de rendu de définir si, oui ou non, 
cette lumière est importante en fonction de paramètres tels que la lumino- 
sité des lumières proches ainsi que des paramètres de qualité définit dans les 
Quality Settings. Le mode Important permet de rendre la lumière pixel 
par pixel, ce qui a un coût réel sur les performances et donc à utiliser que 
dans des cas exceptionnels. Le mode Not Important permet quant à lui de 
rendre la lumière de manière rapide grâce à un système d'affichage plus 
simple. 

— Culling Mask : définit les groupes de layers qui ne seront pas affectés par 
la lumière. 


Remarque 


Le baking est un procédé qui consiste à créer un rendu Low-poly, contenant 
peu de polygones, à partir d'un modèle High-poly, contenant beaucoup de 
polygones, en passant par la création d'une Normal Map qui sera appliquée 
au modèle Low-poly. Cela permet de donner l'illusion d'un rendu en haute 
qualité tout en simplifiant le rendu. Pour les lumières, le baking consiste à créer 
une texture spécifique qui contiendra les informations de la lumière ; c'est ce 
que l'on appelle une lightmap. Cette texture est ensuite appliquée sur l’objet 
grâce à un shader. Il est à noter que la lumière doit obligatoirement être sta- 
tique, donc ne doit pas être déplacée dans la scène. 
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2.2.1 Point 


Les lumières de type Point sont très souvent utilisées pour représenter une 
lampe car la lumière est envoyée dans toutes les directions avec la même 
intensité. La luminosité diminue avec la distance et devient nulle au-delà d'un 
certain seuil. 


Création d'une lumière sans ombre à partir d'un script : 


using UnityEngine; 


public class AddPointLight : MonoBehaviour { 


void Start () 
{ 
Light pointLight = gameObject.AddComponent<Light> () ; 
pointLight.type = LightType.Point; 
pointLight.color = Color.blue; 
pointLight.intensity = 1.5f; 
pointLight.range = 5; 


// Désactivation de l'ombre 
pointLight.shadows = LightShadows.None; 
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2.2.2 Spot 


Le Spot peut être considéré comme une lumière de type Point limitée. En 
effet, il garde toutes les caractéristiques de celle-ci mis à part le fait qu'il soit 
limité par un angle d'action, ce qui lui confère une forme conique. 


Création d'une lumière avec ombres à partir d'un script : 
using UnityEngine; 
public class AddSpotLight : MonoBehaviour { 


+. Start () 
Light spotLight = gameObject.AddComponent<Light> (); 
spotLight.type = LightType.Spot; 
spotLight.color = Color.green; 
spotLight.intensity = 0.5f; 
spotLight.range = 20; 
spotLight.spotAngle = 35; 


// Paramétrage des ombres 

spotLight.shadows = LightShadows.Hard; 

spotLight .renderMode = LightRenderMode.ForcePixel; 
spotLight.shadowStrength = 0.8f; 
spotLight.shadowBias = 0.2f; 
spotLight.shadowNormalBias = 0.31f; 
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2.2.3 Directionnelle 


La lumière de type Directional peut être considérée comme la lumière du 
soleil ou de la lune. Dans une scène Unity, elle n'a pas vraiment de source iden- 
tifiable car elle éclaire l'intégralité de la scène, on peut donc la placer quasi- 
ment n'importe où. Tous les objets de la scène seront donc illuminés par des 
rayons venant tous de la même direction. 


Création d'une lumière avec ombres à partir d'un script : 


using UnityEngine; 


public class AddDirectionalLight : MonoBehaviour 


{ 


void Start () 

{ 
Light directionalLight = gameObject .AddComponent<Light»> (); 
directionalLight.type = LightType.Directional; 
directionalLight.color = Color.red; 
directionalLight.intensity = 1.5f; 
directionalLight.range = 5; 
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// Paramétrage de l'ombre 
directionalLight.shadows = LightShadows.Soft; 
directionalLight.shadowStrength = 0.7f; 
directionalLight.shadowBias = 0.32f; 
directionalLight.shadowNormalBias = 0.4f; 


} 


2.2.4 Aire 


3.1 


Une lumière de type Area est représentée par un rectangle dans l'espace. La 
lumière est émise dans toutes les directions, mais seulement d'un côté du rec- 
tangle. Le calcul de celle-ci est assez coûteux au niveau du processeur, ce qui 
fait qu'elle n'est pas disponible à l'exécution et peut seulement être utilisée 
avec la méthode de baking dans une lightmap. On peut l'utiliser pour simuler 
la lumière d'un néon par exemple. 


. Les shaders et matériaux 


Introduction 


Afin d'afficher un objet à l'écran, le moteur graphique s'appuie sur une combi- 
naison de shader et de matériau. Cette collaboration s'effectue dans le sens où 
un matériau va définir un shader à utiliser, celui-ci va être utile afin de déter- 
miner quelles options sont disponibles dans le matériau. 


Unity fournit un bon nombre de shaders prédéfinis qui peuvent être utilisés 
dans la majorité des cas : c’est le Standard Shader. Il est conseillé de l'utiliser 
pour les rendus classiques comme l'affichage d'un personnage, d'un objet 
solide ou transparent, d'une surface. Il est paramétrable et permet donc de 
rendre la plupart des objets d'une manière réaliste. En parallèle de ce shader, 
Unity en met à disposition des plus spécialisés qui seront utiles uniquement 
dans certains cas : ce sont les Built-in Shaders. 


Lorsque les shaders prédéfinis (Standard Shader et Built-in Shader) ne suffi- 
sent plus, Unity permet d'utiliser vos propres shaders afin de créer des effets 
plus spécifiques. 
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3.2 Les matériaux 


3.2.1 Introduction 


3.2.2 


Un matériau définit comment une surface doit être rendu en prenant en 
compte sa teinte, les textures qu'il peut utiliser et un grand nombre d'autres 
paramètres. Dans Unity, ils sont utilisés principalement avec les composants 
de type Mesh Renderer, Skinned Mesh Renderer, Particle Sys- 
tems, etc. 


Les propriétés 


Un matériau étant fortement couplé à un shader, c'est ce dernier qui définit 
les propriétés réglables que l'Inspector affichera pour le matériau. Malgré tout, 
la classe Material propose plusieurs propriétés de base : 


color : permet de définir la couleur principale du matériau. 


globalllluminationFlags : permet de définir le type d'interaction 
que doit avoir le matériau avec le système de Global Illumination (GT). 


mainTexture : permet de définir la texture principale rattachée au 
matériau. 


mainTextureOffset : permet de définir le décalage à appliquer à la 
texture principale. 


mainTextureScale : permet de définir l'échelle à appliquer à la texture 
principale. 
passCount : permet de récupérer le nombre de passes utilisées dans ce 
matériau. 


renderQueue : permet de définir l'ordre dans la file d'attente de rendu du 
matériau. C'est ce qui permet aux matériaux transparents d'être rendus 
après les matériaux opaques. 


shader : permet de définir le shader à utiliser. 


shaderKeywords : permet de définir des mots-clés pour le shader. Ces 
mots-clés sont utilisés lors de la compilation d’un shader. Le shader peut 
avoir différents comportements en fonction des mots-clés du matériau. 
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Les méthodes 


Pour comprendre à quoi peuvent servir les différentes méthodes exposées par 
la classe Material, il faut comprendre ce qu'est un shader. Nous aborderons 
en détail un peu plus tard dans ce chapitre comment en créer un et quelles 
sont ses composantes. Sachez simplement qu'un shader n'est ni plus ni moins 
qu'un script ayant des propriétés et des fonctions. Les méthodes de la classe 
des matériaux vont servir à manipuler ces propriétés (comme la couleur, la 
brillance.….). 


- CopyPropertiesFromMaterial : permet de copier les propriétés d'un 
matériau vers celui-ci. 

- DisableKeyword : permet de désactiver un mot-clé pour le shader. 

- EnableKeyword : permet d'activer un mot-clé pour le shader. 


- GetColor/SetColor : permet de définir ou de récupérer une couleur 
pour une propriété du shader. 


- GetFloat/SetFloat : permet de définir ou de récupérer un nombre 
flottant pour une propriété du shader. 


- GetInt/SetInt : permet de définir ou de récupérer un entier pour une 
propriété du shader. 


- GetMatrix/SetMatrix : permet de définir ou de récupérer une matrice 
pour une propriété du shader. 


— GetTag : permet de récupérer le tag du shader. 


- GetTexture/SetTexture : permet de définir ou de récupérer une 
texture pour une propriété du shader. 


- GetTextureOffset/SetTextureOffset : permet de définir ou de ré- 
cupérer le décalage de la texture pour une propriété du shader. 


- GetTextureScale/SetTextureScale : permet de définir ou de 
récupérer la taille de la texture pour une propriété du shader. 


— GetVector/SetVector : permet de définir ou de récupérer un vecteur 
pour une propriété du shader. 


- HasProperty : permet de déterminer si le shader possède une propriété. 


- IsKeywordEnabled : permet de savoir si un mot-clé est actif pour ce 
matériau. 
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— Lerp : permet de créer une interpolation entre deux matériaux selon une 
durée définie. 

— SetBuffer : permet de définir un buffer, de type ComputeBuffer, pour 
une propriété du shader. 


— SetOverrideTag : permet de surcharger un tag pour ce matériau. 


- SetPass : permet de définir le numéro de passe à activer pour générer le 
rendu. 


HRemarque 


Lors du paramétrage des valeurs d'un matériau utilisant un Standard Shader, 
assurez-vous d'activer les bonnes caractéristiques en utilisant la méthode 
EnableKeyword. En effet, les mots-clés étant utilisés par le shader pour activer 
certaines fonctionnalités, il ne suffit pas d'assigner une caractéristique pour 
qu'elle soit prise en compte, il faut aussi ajouter le keyword qui activera la 
fonctionnalité qui utilisera cette caractéristique. 


Création d'un matériau 


Afin de voir comment créer et utiliser un matériau, nous allons créer une 
nouvelle scène possédant deux cubes, un au premier plan et l'autre en arrière- 
plan derrière le premier. Le premier utilisera un matériau que l'on aura créé, le 
second utilisera le matériau de base. 


Créez une nouvelle scène via le menu File - New Scene. 


Ajoutez un nouveau cube à partir de la fenêtre Hierarchy - Create - 3D 
Object - Cube et nommez-le TransparentCube. Répétez l'opération pour 
en ajouter un deuxième et nommez-le OpaqueCube. 
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Placez les cubes de façon à ce que TransparentCube soit devant Opaque- 
Cube. 


Créez un nouveau matériau en faisant un clic droit dans la fenêtre Fos - 
Create - Material et nommez-le TansparentMaterial. 


e@ TransparentMater 
Shader [Stand 
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Modifiez le Rendering Mode en Transparent et changez la couleur en 
modifiant la valeur de la propriété Albedo sur #FF000096. 
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DGlissez et déposez le matériau TransparentMaterial sur l'objet Transpa- 
rentCube. Le résultat devrait ressembler à ceci : 


L'ajout du matériau a permis d'ajouter de la transparence à l'objet, ce qui rend 
visible le cube en arrière-plan. 


3.3 Les shaders 


3.3.1 Introduction 


Un shader est simplement un script qui permet de définir comment les pixels 
d'une surface vont être affichés. La définition de ses pixels se fait grâce à des 
algorithmes et des calculs mathématiques (simples ou complexes) en fonction 
du type de rendu voulu (effet miroir, réflexion.….). 


Un shader possède un certain nombre de propriétés qui seront utilisées à 
travers le matériau qui l'utilise. Ces propriétés peuvent être de différentes 
sortes : nombre, couleur, texture. Elles seront toutes visibles via la fenêtre de 
l'Inspector. 


Il est possible d'utiliser le même shader sur plusieurs matériaux différents. 
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3.3.2 Le Standard Shader 


Présentation 


L'arrivée de la version 5 d'Unity coïncide avec l'introduction d'un nouveau 
type de shader appelé Standard Shader. Il a été conçu pour remplacer un grand 
nombre de shaders créés dans les versions précédentes qui servaient pour le 
rendu réaliste des objets comme le bois, le métal, la pierre, le verre. 


Ce shader est utilisé par défaut lors de la création d'un nouveau matériau, ce 
qui permet de ne plus avoir à choisir quel shader spécifique est à utiliser : il les 
remplace tous. Ceci est possible grâce aux différentes propriétés qui sont acti- 
vées ou désactivées en fonction des paramètres et de l'utilisation ou non de 
texture lors de l'édition du matériau. 


HRemarque 
Il existe deux façons d'utiliser ce shader : l'approche standard Metallic ou 


l'approche Specular. Il est possible d'obtenir le même résultat en suivant l'une 
ou l'autre des méthodes, cela repose plus sur une préférence personnelle. 


Physically Based Shading 


Le Standard Shader s'appuie sur le PBS (Physically Based Shading) afin de 
proposer une gestion avancée de la lumière par rapport au type de matériau 
utilisé. Son but est de rendre le plus fidèlement et le plus réaliste possible 
l'interaction entre les différents matériaux et la lumière. Concrètement, il se 
base sur plusieurs principes de physique tels que les formules de Fresnel, qui 
déterminent la réflexion d'une surface en fonction d'un angle, ou encore le 
principe de rétention de la lumière, selon lequel les objets renvoient moins de 
lumière qu'ils n'en reçoivent. 


Le gros avantage de n'avoir plus qu'un seul shader, à l'inverse des versions pré- 
cédentes, est qu'il permet d'utiliser le même calcul pour le rendu des lumières 
car le même shader est utilisé pour la grande majorité des matériaux, il y a 
juste ses paramètres qui changent. 
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Les différents paramètres 


Par défaut, le Standard Shader propose un ensemble de paramètres pour le 
matériau, dont aucune valeur ou texture n'est renseignée. 


Le mode de rendu 


Le premier paramètre est le Rendering Mode. Il permet de choisir le type de 
rendu souhaité : 


— Opaque : permet de définir un rendu entièrement opaque sans zone de 
transparence. 


— Cutout : permet de définir un rendu contenant des zones opaques ou trans- 
parentes. Il est toutefois important de noter que ces zones sont opaques ou 
invisibles à 100 %, ce qui est particulièrement utile pour les objets possédant 
des trous comme les vêtements. 


— Transparent : permet de définir un rendu transparent en se basant sur le 
canal alpha de la teinte et de la texture. C'est le rendu à utiliser en priorité 
pour garder un rendu réaliste pour des matériaux comme le verre. 


— Fade : permet de définir un rendu basé sur les valeurs de transparence. Très 
pratique pour des animations, le rendu sera moins réaliste car les réflexions 
seront aussi affectées par la transparence, ce qui n'est pas le cas dans le 
monde réel. 


Albedo et transparence 


Le paramètre Albedo permet de définir la couleur de base de la surface. Celle- 
ci peut être spécifiée en lui affectant simplement une couleur ou en utilisant 
une texture. Cette texture doit impérativement ne contenir aucune lumière 
ou ombre car cela sera géré par un autre système. 


HRemarque 


Si vous souhaitez utiliser la transparence paramétrée dans la valeur de votre 
Albedo, vous devez choisir un mode de rendu comme Transparent. Cutout ou 
Fade. 
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Les paramètres Metallic et Specular 


Comme précisé précédemment, les artistes peuvent utiliser deux modes diffé- 
rents pour définir la réflexion de la lumière afin de rendre une surface brillante 
par exemple. L'utilisation d'une texture permet de définir des zones qui réflé- 
chissent plus que d'autres dans un même matériau. Par exemple, pour une 
épée en fer possédant un pommeau en cuir, la réflexion ne sera pas la même 
sur la lame en fer et sur le cuir. 


Il est aussi possible de définir la granularité de la surface grâce au paramètre 
Smoothness. Plus sa valeur devient élevée, plus la surface du matériau 
devient lisse, ce qui rend les réflexions spéculaires plus claires et plus nettes. 


Bump Map 


Comme les textures ne prennent pas en compte le relief (pas de notions de 
hauteur ou de profondeur), on utilise ce que l'on appelle des Bump Map. Ce 
sont des textures spéciales qui permettent d'ajouter des détails à la surface 
comme une griffure, une bosse, etc. Dans une approche d'amélioration des 
performances, il est préférable de ne pas représenter des petits détails, comme 
une vis ou un écrou, en tant qu'objet fait de polygones. Ils n'apportent que très 
peu à la scène mais rajoutent potentiellement un nombre important de poly- 
gones à dessiner. 


À partir de ce postulat, l'utilisation de Bump Map permet un gain de perfor- 
mance non négligeable car la géométrie de la surface devient très simple : une 
texture 2D. 


Une Normal Map représente la manière dont la lumière est réfléchie sur la 
surface, ce qui peut simuler un effet de profondeur. 
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Une Heïght Map peut s'apparenter à une Normal Map mais permet d'aller 
plus loin dans le niveau de détail. Elle permet d'obtenir un effet d'occlusion de 
certaines zones en fonction de la profondeur définie. Concrètement, les bosses 
verront les côtés les plus proches, face à la caméra, agrandis et les côtés les plus 
loin apparaîtront comme à peine visible. Cet effet est donc le plus visible 
lorsque l'on regarde la texture avec un angle assez prononcé. Si on imagine une 
maison faite de rondins de bois de différentes épaisseurs, certaines parties de 
rondins seront masquées par des rondins plus épais, chose qu'il n'est pas pos- 
sible à réaliser avec une Normal Map qui n'influe que sur la lumière à travers 
la surface de la texture. 


Sur l'illustration suivante, on remarque bien que les zones sombres correspon- 
dent aux parties les plus profondes et que les zones claires aux parties les plus 
proches. 


Occlusion Map 


Il est parfois utile de pouvoir définir des zones du modèle pouvant recevoir un 
éclairage indirect plus ou moins fort. Ceci est particulièrement utilisé pour des 
fissures ou des trous qui, dans le monde réel, ne reçoivent que peu de lumière 
à l'intérieur. 

Pour définir cette Occlusion Map, on utilise simplement une image en 
échelle de gris avec le noir indiquant qu'il n'y a aucun éclairage indirect et 
inversement pour le blanc. Cette image est généralement générée automati- 
quement par un logiciel 3D spécialisé à partir du modèle 3D auquel il fait réfé- 
rence. 
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Emission 


Le paramètre Emission permet de définir des zones dites "auto-éclairées". Ces 
zones pourront donc être visibles dans une scène même s'il n'y a aucun éclai- 
rage. Ceci est particulièrement utilisé pour les écrans, les tableaux de bord, etc. 


HRemarque 
Il est possible de modifier le comportement de l'émission vis-à-vis du système 
de Global lllumination pour qu'il interagisse ou non avec les autres objets de 
la scène. 


Detail Mask et Secondary Maps 


Toujours dans une optique d'obtenir un niveau de détail en fonction de la dis- 
tance de la caméra par rapport à l'objet, un second niveau de texture peut 
s'appliquer au-dessus de la principale. L'utilisation la plus répandue est l'ajout 
de la porosité de la peau d'un personnage ou de la barbe. Lorsque la caméra est 
éloignée du personnage, il n'est pas nécessaire d'utiliser autant de détail donc 
ces paramètres sont ignorés. Lorsque la caméra est très près du personnage, le 
niveau de détail augmente par la même occasion et ces paramètres sont pris 
en compte dans le rendu final. 
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Les Built-in Shaders 


Les versions précédentes d'Unity ont introduit un bon nombre de shaders qu'il 
est encore possible d'utiliser même si l'usage du Standard Shader est recom- 
mandé. Il existe cinq grandes familles : 


— Normal Shader : cette famille comprend les shaders à utiliser pour les 
objets opaques : 
— Vertex Lit, Diffuse, Specular, Bumped Diffuse, Bumped Specular, Parallax 
Diffuse, Parallax Specular, Decal, Diffuse Detail. 


- Transparent Shader : cette famille comprend les shaders à utiliser pour les 
objets utilisant la transparence : 
— Transparent Vertex Lit, Transparent Diffuse, Transparent Specular, 
Transparent Bumped Diffuse, Transparent Bumped Specular, Transpa- 
rent Parallax Diffuse, Transparent Parallax Specular. 


— Transparent Cutout : cette famille comprend les shaders à utiliser pour les 
objets ayant des zones entièrement opaques et d'autres invisibles (entière- 
ment transparents) : 

— Transparent Cutout Vertex-Lit, Transparent Cutout Diffuse, Transpa- 
rent Cutout Specular, Transparent Cutout Bumped Diffuse, Transparent 
Cutout Bumped Specular. 


- Self-Illuminated Shader : cette famille comprend les shaders à utiliser 
lorsqu'une partie doit être "auto-éclairée" : 

- Self-Iluminated Vertex-Lit, Self-Iluminated Diffuse, Self-Illuminated 
Specular, Self-IIluminated Normal mapped Diffuse, Self-Illuminated Nor- 
mal mapped Specular, Self-Illuminated Parallax Diffuse, Self-Illuminated 
Parallax Specular. 


— Reflective Shader : cette famille comprend les shaders à utiliser lorsque 
l'on souhaite personnaliser la réflexion du matériau : 

— Reflective Vertex-Lit, Reflective Diffuse, Reflective Specular, Reflective 
Bumped Diffuse, Reflective Bumped Specular, Reflective Parallax Diffuse, 
Reflective Parallax Specular, Reflective Normal Mapped Unlit, Reflective 
Normal mapped Vertex-lit. 
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HRemarque 


Il est important de bien choisir le shader le plus adapté à ce que l'on souhaite 
faire et ne pas choisir un shader trop complexe pour effectuer une tâche 
simple. Par exemple, si on souhaite afficher un matériau opaque sans ré- 
flexion, il n'est pas nécessaire d'utiliser un shader de type "Parallax Normal 
mapped”" mais plutôt un shader de type "Vertex Lit", 


3.3.4 Les shaders personnalisés 


Introduction 


Si vous n'arrivez pas à trouver votre bonheur avec le Standard Shader ou les 
Built-in Shaders, il est possible de créer son propre shader. Cette tâche étant 
généralement réservée aux développeurs expérimentés, nous allons donc voir 
les grands principes sans entrer dans les détails techniques. 


Concrètement, un shader peut se résumer à quelques lignes de codes pour les 
plus simples, à des centaines pour les plus complexes. Pour créer un shader, il 
existe deux possibilités qui dépendent de la complexité et du type de celui-ci : 
les Surface Shaders et les Vertex/Fragment Shaders. Ces deux types de 
programmation ont un point commun : ils utilisent tous les deux la syntaxe 
appelée ShaderLab afin de définir la structure du shader. 


Surface Shader 


Les Surface Shaders sont utilisés lorsque l'on souhaite créer un shader qui 
interagit avec les lumières et les ombres. On utilise le langage Cg/HLSL (High 
Level Shader Language) pour décrire l'effet voulu en utilisant un haut niveau 
d'abstraction permettant de simplifier grandement la création du shader. 


Remarque 


L'utilisation des Surface Shaders est réservée uniquement lorsque l'on souhaite 
avoir un traitement en relation avec les lumières. Si vous choisissez ce type de 
shader alors que vous ne prenez pas en compte l'éclairage, de nombreux 
calculs de lumière seront quand même exécutés, ce qui est une perte en 
termes de performance. 
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Exemple de Surface Shader 


Shader "MyShader/Surface Shader" { 
SubShader { 
Tags { "RenderType" = "Opaque" } 
CGPROGRAM 
#pragma surface surf BlinnPhong 
struct Input { 
float4 color : COLOR; 
}e 


void surf (Input IN, inout SurfaceOutput o) { 
o.Albedo = 0.7; 
} 


ENSDCG 


} 


Fallback "Diffuse" 


} 


Ce shader modifie toutes les données lui étant passées, à savoir les informa- 
tions de couleur, pour les remplacer par une couleur unique. Cela se fait grâce 
à la fonction surf qui prend en paramètre la couleur actuelle (Input IN)et 
renvoie la couleur modifiée (inout SurfaceOutpout o). Le chargement 
de la couleur est effectué en modifiant le paramètre Albedo. 


Vertex/Fragment Shaders 


Contrairement aux Surface Shaders, ce type est à privilégier dès lors que les 
lumières n'ont aucune interaction avec le shader. Ils permettent de créer des 
effets très spécifiques et offrent une très grande souplesse car ils utilisent un 
faible niveau d'abstraction. Le désavantage est donc logiquement qu'ils sont 
plus complexes à écrire et demandent beaucoup plus de lignes de code, tou- 
jours en Cg/HLSL. 


Exemple de Vertex-Fragment Shader 


Shader "MyShader/VertexFragment Shader" { 
SubShader { 
Pass { 
CGPROGRAM 


#pragma vertex vert 
#pragma fragment frag 
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float4 vert (float4 v:POSITION) : SV POSITION { 
return mul (UNITY MATRIX MVP, v); 

} 

fixed4 frag() : SV Target { 

} 

ENDCG 


} 


Ce shader est l’un des plus simples possible et ne fait rien de spécial. Il définit 
la fonction qui sera chargée de la partie Vertex (Hpragma vertex vert)et 
celle chargée de la partie Fragment (#pragma fragment frag).La fonction 
vert effectue simplement une transformation du vertex via un calcul matri- 
ciel et retourne le résultat. 


Les meshes 


Présentation 


Comme nous avons pu le voir dans le chapitre Le GameObiject et ses compo- 
sants, à la section Les meshes, les meshes font partie intégrante de la plupart 
des objets d'une scène. Ils représentent la structure géométrique de l'objet et 
de ce fait, une grande partie de son aspect général. 


L'éditeur d'Unity n'étant pas fait pour modéliser ce type d'objet directement, 
il peut néanmoins charger la plupart des modèles créés à partir de logiciels 
tiers. Parmi ceux-ci on retrouve les formats .FBX, .dae, .3DS, .dxf et .obj pour 
les formats universels. Il peut aussi importer un grand nombre de types de 
fichiers créés à partir de logiciels propriétaires comme Blender, Cinema4D, 
Maya. 
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Mesh Filter 


Le composant Mesh Filter fonctionne de pair avec le composant Mesh 
Renderer. Il permet simplement de spécifier le modèle à utiliser, celui-ci 
devant être dans le dossier Assets (à la racine du projet), à travers la propriété 
mesh. 


Mesh Renderer 


Introduction 


Le composant Mesh Renderer récupère le modèle défini à partir du Mesh 
Filter et s'occupe de l'afficher. 


Les propriétés 

Plusieurs paramètres sont disponibles afin de régler le rendu de l'objet à 

l'écran : 

- Cast Shadows : permet d'activer ou non la génération d'une ombre s'il est 
exposé à de la lumière. 


- Receive Shadows : permet d'activer ou non la réception d'ombre d'autres 
objets. 


- Materials : permet de définir la liste de matériaux à afficher lors du 
rendu. 


4.4 Skinned Mesh Renderer 


Le composant Skinned Mesh Render est utilisé quand une animation 
déforme la géométrie du mesh. Ceci est très souvent utilisé lorsque l'on anime 
un personnage. 


Dans ce type d'animation, on utilise des objets invisibles, appelés bones, afin 
de définir le squelette du personnage, du monstre... Une fois le squelette 
assemblé, les animations se font à partir de chacun des bones en les faisant 
tourner selon différents angles afin d'obtenir le mouvement voulu. 
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Les deux caractéristiques importantes sont Mesh qui définit le mesh à utiliser 
et Root Bone qui définit l’objet parent qui servira de squelette pour le person- 
nage. 
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4.5 Text Mesh 


Les meshes peuvent aussi servir à afficher du texte, cela se fait grâce au com- 
posant Text Mesh. Très simple d'utilisation, il suffit de renseigner le texte à 
afficher dans la propriété Text, de choisir la couleur via la propriété Color et 
de configurer une police à travers le paramètre Font. 


La police à utiliser doit être au format TrueType Fonts (.ttf) ou Open Type 
Fonts (.otf). Pour importer une police, faites-la simplement glisser dans la 
fenêtre Project. L'Inspector vous permet ensuite de définir la taille et le style 
par défaut. 


Unity permet aussi de gérer des fichiers texte comme des assets. Ces fichiers 
doivent obligatoirement être aux formats .txt, html, .htm, xml, bytes, .json, 
.csv, .yaml, .fnt et être placés dans le dossier Resources. Ce dossier doit être créé 
à La racine du dossier Assets et contient généralement les fichiers de traduction, 
des textes d'aide, des fichiers de configuration... Ceci est par exemple très pra- 
tique pour charger des textes qui seront édités en dehors de l'éditeur. 


218 Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Il suffira de les charger grâce à un script comme celui-ci : 


using UnityEngine; 


public class LoadTextAsset : MonoBehaviour 


{ 
void Start) 
{ 
TextAsset file = Resources.Load("title") as TextAsset; 
if (file != null) 
{ 
GetComponent<TextMesh> ().text = file.text; 
} 
else 
{ 
GetComponent<TextMesh> ().text = "Erreur...'; 
} 
} 
} 
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. Les textures 


Présentation 


L'utilisation des textures est omniprésente dans la plupart des objets d'une 
scène. Elles sont par exemple utilisées afin de donner vie aux meshes grâce à 
l'ajout d'une image ou d'une vidéo qui vient s'appliquer au modèle, lui donnant 
une consistance. 


Nous avons vu dans la section précédente que les shaders utilisent des tex- 
tures différentes (Normal Map, Height Map...) qui sont adaptées au matériau 
et au modèle qui sera utilisé. Concrètement, n'importe quelle image peut 
devenir une texture pour peu que la taille requise soit bonne. 


5.2 Les types de texture 


Lorsque l'on sélectionne une image ou une texture, l'Inspector nous propose 
de nombreux réglages : 


- Texture Type : permet de définir le type de texture dont les principaux 
types sont : 

- Texture : ce paramètre est utilisé pour la majorité des textures de base 
qui ne sont pas spécifiques (Normal Map, Sprite, Cubemap, etc.). C'est le 
paramètre par défaut. 

- Normal Map : définit la texture afin de pouvoir l'utiliser comme une 
Normal Map. 

— Editor GUI : définit cette texture afin de l'utiliser dans des contrôles de 
l'UI. 

- Sprite (2D and UT) : définit cette texture afin de l'utiliser comme un 
sprite 2D. 

— Cubemap : définit cette texture afin de l'utiliser pour créer de la réflexion. 

— Advanced : ce paramètre est utilisé afin de pouvoir paramétrer l'intégra- 
lité des propriétés d'une texture. 
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Nous nous intéresserons uniquement aux deux premiers types à savoir 
Texture et Normal Map car ils sont très souvent utilisés. Les textures de 
type Editor GUI sont abordées dans le chapitre Unity UI et interfaces utili- 
sateurs traitant de l'interface utilisateur. 


Les textures simples 


Lorsque l'on sélectionne le type de texture Texture, l'Inspector nous propose 
une liste de propriétés pour paramétrer le rendu de celle-ci : 


— Wrap Mode : permet de définir le mode d'affichage : 
— Repeat : la texture est répétée (type mosaïque). 
— Clamp : les bords de la texture sont étirés. 

— Filter Mode : permet de définir le type de filtre à appliquer quand la texture 
est étirée (Point, Bilinear, Trilinear). 


— Aniso Level : permet de définir le niveau de qualité de la texture lorsqu'elle 
est visible avec beaucoup d'angle. 


Default 


x Size 
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Les Normal Maps 


Lorsque l'on sélectionne le type de texture Normal Map, l'Inspector nous pro- 
pose une liste de propriétés pour paramétrer le rendu de celle-ci : 


— Create from Grayscale : si activé, l'échelle de gris de l'image est utilisée 
comme Height Map pour créer les Normal Maps. 


— Bumpiness : permet de définir la granularité. 


- Filtering : permet de définir le type de filtre à appliquer pour le calcul des 
Normal Maps : 


— Smooth : génère une Normal Map lisse. 
— Sharp : génère une Normal Map nette. 
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Les sprites 


Présentation 


Les sprites sont des objets 2D utilisés pour afficher des éléments graphiques. 
Ils sont créés à partir d'images ou textures. La spécificité d'un sprite est qu'il 
permet d'afficher tout ou partie d'une image, ce qui permet de créer plusieurs 
sprites différents à partir d'une seule image. 


Sprite Renderer 


Afin d'afficher une image, il suffit d'utiliser le composant Sprite Renderer 
et de lui associer l'image souhaitée. Le sprite sera rendu à l'écran à la position 
de l'objet dans la scène. 


Il est aussi possible de définir une couleur et un type de matériau spécifique. 
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6.3 Sprite Editor 


Présentation 


Une image peut contenir un ou plusieurs éléments graphiques qui seront 
utilisés à chaque fois comme un sprite à part. On représente donc souvent un 
personnage entier dans une seule image avec l'ensemble des parties du corps 
détachées les unes des autres. Afin que l'éditeur connaisse où se situe chacun 
de ces éléments dans l'image, il faut faire appel au Sprite Editor. 


Pour ouvrir l'éditeur de sprite, il suffit de sélectionner une image de type 
Sprite (2D and UT) et de cliquer sur le bouton Sprite Editor. 


Default 


Remarque 


Afin de pouvoir être en mesure d'utiliser le découpage d'une image en 
plusieurs éléments différents, il faut obligatoirement sélectionner l'option 
Multiple sur le Sprite Mode. 


Une fenêtre s'ouvre, permettant de paramétrer les différents éléments gra- 
phiques de l'image. 
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Génération manuelle 


La première façon pour identifier les éléments de l'image est de le faire manuel- 
lement. Sélectionner la zone souhaitée en cliquant puis en déplaçant la souris. 
Un rectangle bleu apparaît afin de spécifier les limites de l'élément. Vous avez 
alors la possibilité de manipuler cette zone afin de l'agrandir, déplacer ou tout 
simplement la supprimer. 


Sprite Editor 


Une fois tous les éléments identifiés, cliquez sur le bouton Apply pour valider 
les changements. 
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Génération automatique 


Il existe plusieurs méthodes pour identifier les éléments de manière automa- 
tique. La première laisse l'éditeur déterminer par lui-même de façon intelli- 
gente les éléments dans l'image. Cela fonctionne très bien si les éléments sont 
séparés clairement et proprement et s'ils sont en une seule partie. Pour utiliser 
cette fonction, il suffit d'utiliser dans le menu Slice le type Automatic puis 
de cliquer sur le bouton Slice. 


La deuxième méthode va se baser sur un pattern bien défini pour faire le 
découpage. Par exemple, si tous vos éléments font une largeur de 40 px et une 
hauteur de 35 px, il est préférable d'utiliser le type de découpage Grid By Cell 
Size. Pour faire un découpage à partir d'un nombre de colonnes et de lignes, il 
faut utiliser l'option Grid By Cell Count. 
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Introduction 


Dans un jeu vidéo, l'importance de la musique est souvent sous-estimée alors 
qu'elle fait partie intégrante de l'ambiance générale du jeu. Avec Unity, il est 
possible d'ajouter une ambiance sonore riche et variée en y ajoutant des sons 
s'intégrant parfaitement dans un environnement 8D. 


Un gros travail a été fait afin de rendre la perception des sons de manière réa- 
liste. Dans la vraie vie, les sons sont perçus en fonction d'une distance, d'une 
intensité, d'un environnement. Si le son provient d'un objet qui bouge rapide- 
ment, il va être perçu différemment selon la distance entre votre oreille et 
l'objet : c'est ce qu'on appelle l'effet Doppler. De la même manière, un bruit 
dans une pièce entièrement fermée et vide ne va pas être perçu comme dans 
un espace entièrement ouvert. 


Ce sont tous ces effets qu'Unity a reproduits à l'intérieur de son moteur de jeu 
en essayant de rester le plus fidèle possible avec la réalité. Afin d'intégrer un 
son dans une scène, il faut donc qu'il soit rattaché à un objet de celle-ci, les 
filtres s'appliquant de la même façon. 


Audio Listener 


Le composant qui sert à imiter notre oreille est l'Audio Listener. Il enre- 
gistre tous les sons pour les rejouer sur les haut-parleurs du joueur. Il est 
important de noter qu'il n'est pas possible d'avoir plusieurs Audio Liste- 
ner dans une même scène et le seul est ajouté par défaut à la caméra princi- 
pale. 


Les effets qui peuvent être ajoutés aux sons, comme la réverbération (Audio 
Reverb Filter), sont directement pris en compte par le composant. 
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7.3 Audio Clip 


Un son est représenté par la classe AudioClip qui contient ses données 
brutes, qui seront par la suite utilisées par le composant Audio Source afin 
de pouvoir les lire dans la scène. Plusieurs formats audio différents sont utili- 
sables comme .mp3, .wav, .aif ou .0gg. 


Lorsqu'un son est ajouté au projet, celui-ci est automatiquement converti 
dans un nouveau format dépendant de son type et de la plateforme ciblée. Les 
deux formats recommandés sont le PCM et Vorbis/MP3. 


© Inspector ._. 
wing_flaps Import Settings 


ù  . 


Default 


Load Type 
Compression Format 
Quality 

Sample Rate Setting [Preserve Sample Rate 


Wing 


Vorbis, 44100 Hz, Mono, 00:12.585 
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7.4 Audio Source 


Afin de lire un son il faut donc la combinaison de trois composants différents : 
Audio Listener, Audio Clipet Audio Source. Nous avons vu que le 
premier représente notre oreille et le second notre chanson préférée. Il ne reste 
plus que notre voix afin de pouvoir la chanter ! C'est exactement ce que fait le 
composant Audio Source, il permet de lire un son (Audio Clip), de 
moduler le volume, de changer de rythme... 


Une fois le composant ajouté à un objet de la scène, il est très facile de le 
manipuler via un script. Dans cet exemple, le son sera joué après un délai de 
trois secondes : 


using UnityEngine; 


public class PlayAudioSource : MonoBehaviour 


{ 


public float Delay = 3; 


void Start () 


{ 
AudioSource _audioSource = GetComponent<AudioSource» () ; 
_audioSource.loop = false; 
_audioSource.playOnAwake = false; 
_audioSource.volume = 0.5f; 
_audioSource.PlayDelayed (Delay) ; 


} 


Pour arrêter ou mettre en pause, cela est tout aussi facile, il suffit d'utiliser les 
méthodes Pause et Stop. 


HRemarque 


Par défaut, l'option Play On Awake est cochée, ce qui jouera le son automar- 
tiquement une fois chargé. 
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7.5 Audio Mixer 


L'éditeur a récemment reçu une fonctionnalité qui devrait plaire aux sound 
designers : l'Audio Mixer. Il permet de gérer les sources audio en groupe afin 
d'affecter des effets ou régler le volume à différents sons en même temps. Pour 
afficher la fenêtre d'administration, sélectionnez l'option Audio Mixer dans 
le menu Window. 
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Créez un nouveau Mixer en cliquant sur le + à droite. Vous pourrez à présent 
ajouter des groupes de la même manière. Un groupe nommé Master est créé 
automatiquement ; il servira de groupe maître pour tous les autres. Les effets 
appliqués au groupe Master seront donc appliqués à tous les autres. 


Pour attacher une Audio Source à un groupe, il suffit de le lier via la propriété 
Output. Le son sera alors affecté à ce groupe et les effets de celui-ci s'y appli- 
queront. 


Les filtres et effets 


Unity fournit une liste d'effets et de filtres permettant de modifier la source 
audio de différentes manières. Les filtres s'appliquent à une Audio Source 
quand les effets s'appliquent à un groupe. Il est donc possible d'ajouter de 
l'écho (Audio Echo Filter, Audio Echo Effect), de la distorsion (Audio 
Distortion Filter, Audio Distortion Effect), etc. 


Pour ajouter un effet à un groupe, ouvrez l'Audio Mixer et cliquez sur le 
bouton Add situé en bas de chaque groupe. Si vous cliquez sur un groupe, 
l'Inspector vous propose alors la liste des filtres avec l'ensemble de leurs 
paramètres. 
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Pour ajouter un filtre à une source audio, ajoutez simplement le composant à 
l'objet contenant l'Audio Source. 
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Batching et Draw Calls 


Présentation 


Si l'affichage des objets d'une scène peut paraître magique, il n'en reste pas 
moins qu'il s'agit de traitement effectué par une API graphique 3D ou 2D 
(comme Direct3D ou OpenGL). Ses appels peuvent être coûteux en termes de 
performance lorsque les ressources changent, par exemple lorsque le matériau 
n'est plus le même, ce qui provoque des montées en charge significatives pour 
le CPU. Ces demandes de rendu sont appelées Draw Calls et il peut y en avoir 
un très grand nombre. Unity a mis en place deux systèmes de regroupement 
appelés Static Batching et Dynamic Batching afin d'optimiser ses appels et 
gagner en performance. 


Remarque 
Seuls les Mesh Renderer et les Particle Systems peuvent utiliser ces systèmes. 


Static Batching 


Il permet au moteur de réduire le nombre de Draw Calls en regroupant les 
objets utilisant le même matériau et ne bougeant pas dans la scène (rotation, 
translation, taille). Afin d'activer ce comportement à un GameObject, il faut 
le spécifier directement dans l'Inspector en cochant la case Static. 
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Remarque 


Il est préférable d'utiliser cette méthode au Dynamic Batching car cela de- 
mande beaucoup moins de ressources en CPU mais un peu plus en mémoire. 


Dynamic Batching 


Contrairement au précédent système, le Dynamic Batching permet de regrou- 
per les objets pouvant bouger dans un seul et même Draw Call s'ils respectent 
un certain nombre de critères : 

— partager le même matériau, 

— ne pas utiliser la réception d'ombres en temps réel (receive real-time shadows), 
— ne pas utiliser de meshes contenant plus de 900 attributs de vertex au total, 


utiliser la même échelle (Scale) pour le Transform, par exemple (1,1,1). 
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1. Présentation de Mecanim 


1.1 Présentation 


Unity fournit un système d'animation très complet appelé Mecanim. Celui-ci 
permet de créer des animations à partir de chacun des GameObijects en jouant 
sur leurs propriétés. Il est aussi possible de visualiser les animations et les tran- 
sitions à l'intérieur de l'éditeur. Pour l'animation de personnage, chaque partie 
du corps peut être animée avec des logiques différentes. Une machine à état 
visuelle permet, quant à elle, de créer des workflows complexes d'animations 
avec des transitions et des conditions. 


Le système d'animation repose entièrement sur les clips d'animation (Anima- 
tion Clips) qui servent à stocker les informations comme les changements de 
position, de couleur ou de n'importe quelles autres propriétés d'un objet en 
fonction d'un temps donné. Concrètement, ils vont servir à traduire en code 
une action comme "Changer la couleur de mon cube en rouge à la troisième 
seconde". Ces Animation Clips sont donc structurés de manière à ce qu'ils 
puissent être traités et manipulés par un animateur (Animator Controller). 
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Les animations 


Introduction 


Les Animation Clips sont au cœur de Mecanim car ils définissent comment 
vont se comporter les objets pour une animation donnée (courir, sauter, 
nager…). Il existe plusieurs façons pour les créer : 


à partir d'Unity, 


à partir de logiciels tiers comme 3DS Max ou Cinema 4D, 


à partir de l'Unity Asset Store, 


à partir de données venant de capture de mouvement grâce à des capteurs 
(motion capture). 


Nous ne traiterons pas les animations provenant de sources externes car ce 
n'est pas le but de ce livre. Nous nous concentrerons sur la création d'anima- 
tions avec l'outil interne d'Unity. 


La fenêtre Animation 


Unity fournit une fenêtre permettant de créer, modifier ou supprimer des ani- 
mations. Elle s'ouvre à partir du menu Window - Animation. En sélection- 
nant un objet dans la hiérarchie ou dans la scène, la fenêtre affiche les 
animations qui le concernent. 


On remarque que les animations sont représentées sur une timeline (ligne de 
temps) en y ajoutant des keyframes (points clés représentés par des losanges) 
lorsqu'un changement sur un objet est souhaité. La barre de menu permet 
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ou un événement ESRI] La ligne rouge représente le temps actuel dans 
l'animation. Elle peut être manipulée pour se placer à un temps donné afin de 
créer un nouveau keyframe. L'ensemble des modifications sur les propriétés 
d'un objet apparaît dans la liste de gauche avec les valeurs associées. 
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Il existe deux modes de représentation des animations : Dopesheet et 
Curves. Le premier correspond à la capture d'écran ci-dessus. Le second se 
base sur une visualisation des animations sous forme de courbes (capture 
d'écran ci-dessous). 


Dans ce mode de représentation, les variations entre deux états sont représen- 
tées sous forme de courbes, ce qui permet de définir comment le changement 
doit s'effectuer entre les deux états (accélération, effet yoyo... 
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Les animateurs 


Introduction 


Afin de pouvoir gérer une ou plusieurs animations, les enchaînements entre 
elles ou les transitions, Unity fournit une classe appelée Animator- 
Controller qui peut être représentée comme une machine à état afin de 
produire des séquences d'animations simples ou complexes. 


Le composant Animator permet, quant à lui, de faire la liaison entre un 
GameObiject et un Animator Controller. C'est grâce à lui qu'il est possible de 
jouer telle ou telle animation. 


La fenêtre Animator 


Afin de pouvoir mettre en place les différents états de l'Animator Controller, 
Unity a créé une fenêtre spécifique pouvant s'ouvrir à partir du menu 
Windows - Animator. Lorsque vous sélectionnez un animateur dans la 
fenêtre Project, vous voyez la représentation visuelle de la machine à état, ce 


qui simplifie fortement la création de séquences d'animation. 


Par défaut, un animateur est composé de plusieurs états automatiquement 

créés : 

— Entry : c'est le point d'entrée qui permet de déterminer vers quel état navi- 
guer en fonction des paramètres d'entrée. 


— Exit : permet de forcer la machine à état à s'arrêter, aucun autre traitement 
ne peut être fait après celui-ci. 


© Editions ENI - All rights reserved 


239 


Le système d'animation 
Chapitre 7 


L'exemple abordé à la section Créer des animations permettra de comprendre 
le fonctionnement de la fenêtre Animator. 


1.3.3 Ajouter un état 


Pour ajouter un état, il suffit de faire un clic droit sur la grille et de choisir 
Create State - Empty. Sélectionnez ensuite l'état créé pour lui lier une ani- 
mation grâce à la propriété Motion. 
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HRemarque 


Il est possible de modifier la vitesse de l'animation en jouant sur la propriété 
Speed. Ce paramètre agit comme un facteur qui s'applique sur la vitesse de 
base de l'animation. 


Ajouter une transition 


Afin de créer une transition entre deux états, sélectionnez l'état d'origine et 
faites un clic droit. Cliquez ensuite sur Make Transition puis sélectionnez 
l'état vers lequel vous souhaitez naviguer. Une flèche entre les deux états est 
ajoutée afin de matérialiser la liaison. 


Créer des animations 


Mise en place de la scène 


Pour bien comprendre le fonctionnement de Mecanim, nous allons animer des 
objets simples en leur affectant des animations et en les contrôlant grâce à un 
script. 


Créez une nouvelle scène (File - New Scene). 
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DParamétrez la caméra de cette façon : 
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Ajoutez une lumière directionnelle (Create - Light - Directional Light) à 
partir de la fenêtre Hierarchy et paramétrez-la comme ceci : 


Ajoutez un nouvel objet vide (Create - Create Empty) nommé Player qui 
sera le GameObject parent de deux autres éléments : 
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Ajoutez un cube (Create - 3D Object - Cube) comme enfant de Player. 


Player. 
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Ce qui donne comme résultat final : 


2.2 Création de l'animation 


La scène étant en place, il ne reste plus qu'à créer l'animation que l'on souhaite. 
Dans notre exemple, nous allons créer une animation permettant de faire 
tourner l'objet Player. 


Affichez les deux fenêtres Animation et Animator à partir du menu 
Window. 


Sélectionnez l'objet Player et cliquez sur le bouton Create dans la fenêtre 
Animation. 


Animation 
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Cela a pour effet de créer et d'ajouter automatiquement un composant 
Animator sur cet objet et propose de créer une nouvelle animation. 
Appelez-la RotateAnimation.anim et validez. 


Le composant apparaît dans l’Inspector : 


Dans la fenêtre Animation, déplacez la ligne sur la timeline (en cliquant 
dans le repère gradué en haut de la fenêtre) et arrêtez-vous au repère 0:30. 


Dans la fenêtre Inspector, affectez la valeur 360 pour la rotation sur l'axe 
gx 
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© Inspector 


Si vous lancez le jeu, vous devez voir votre objet tourner très vite sans s'arré- 
ter. Ce comportement est dû au fait que l'animateur créé par défaut exécute 
l'animation au lancement de l'application. 


88 Animator 


-Ltayers || Parameters | @ Base Layer . 
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… et celle-ci est configurée pour être jouée en boucle, la propriété Loop Time 
étant activée : 


Configuration de l'animateur 


Notre but est de pouvoir lancer l'animation quand on le désire via un script, le 
comportement de base doit donc être changé. Une solution est de créer un 
nouvel état appelé Idle ne faisant rien et qui sera appelé à la place de l'état 
RotateAnimation. 


Dans la fenêtre Animator, faites un clic droit dans la grille et ajoutez un 
nouvel état vide (Create State - Empty). Sélectionnez-le et changez son 
nom en Idle dans l'Inspector. 


Base Layer 
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DRemplacez l'état par défaut en cliquant droit sur l'état Idle et en choisissant 
l'option Set as Layer Default State : 


#8 Animator : . .— 
 |Layers i Parameters ; Base Layer : Auto Live Link 


List is Empty 


Dans la fenêtre Project, sélectionnez l'animation RotateAnimation et 
décochez la case Loop Time dans l'Inspector afin qu'elle ne tourne plus en 
boucle une fois lancée. 


© Inspector . 


Curves Pos: 0 Rot: 1 Scale: O Muscles! D Generic: 
sue Cr 4, Constant: 0 (0.0%) Dense: 0 (| 


© Editions ENI - All rights reserved 


2.4 


Le système d'animation 
Chapitre 7 


Ajout de paramètres 


Si vous testez le jeu à cette étape, l'objet ne doit plus tourner car il est relié à 
un état (Idle) ne référençant aucune animation. On va pouvoir mettre en 
place la logique permettant de lancer l'animation quand on le souhaite. Dans 
notre exemple, on veut qu'elle soit exécutée lorsque le joueur appuie sur la 
touche R. Il faut donc récupérer l'Animator de l'objet afin de lancer l'anima- 
tion grâce à un trigger (déclencheur). 


Il est possible d'ajouter des paramètres de type bool, int, float ou des trigger 
donc un Animator afin de gérer des conditions de lancement des animations. 
On pourra par exemple ne déclencher une animation que si un paramètre 
"compteur" a une valeur supérieure à 3. Le changement de cette valeur se fait 
grâce à un script. Le déclenchement d’un trigger se fait lui aussi avec du code. 


C'est exactement ce que nous allons faire ici, nous allons utiliser un trigger 
afin de déclencher notre animation à partir du script. 


Dans la fenêtre Animator, créez une transition entre l'état Idle et 
RotateAnimation (clic droit sur Idle - Make transition - clic gauche sur 


RotateAnimation) et une autre dans le sens inverse (RotateAnimation 
vers Idle). 


ÉÉTENEPLIRnn re A Let | 


List is Empty 
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Dans la liste de gauche de l'Animator, ajoutez un paramètre de type déclen- 
cheur (bouton +, option Trigger) et nommez-le RotateTrigger. 


Ajoutez un autre paramètre de type entier (bouton +, option Int) nommé 
RotateCount. 


fé Animator 
| Base Layer 


2.5 Ajout de conditions 


Les paramètres sont configurés et prêts à être utilisés, il ne manque plus qu'à 
créer les conditions de lancement de l'animation. 


Dans la fenêtre Animator, sélectionnez la flèche représentant la transition 
entre l'état Idle et l'état RotateAnimation. Dans l'Inspector, ajoutez les 
conditions en cliquant sur le bouton + de façon à obtenir le résultat suivant : 
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Une fois les conditions ajoutées, l'animation ne peut être lancée que si le trig- 
ger RotateTrigger est déclenché et si le paramètre RotateCount est inférieur 
à cinq. 


2.6 Lancement de l'animation 
La dernière étape concerne le lancement de l'animation grâce à un script 
personnalisé. 


Sélectionnez l'objet Player dans la Hierarchy puis ajoutez-lui un script 
nommé RotatePlayer via l'Inspector (Add Component - New Script - 
Create and Add). 


using UnityEngine; 


public class RotatePlayer : MonoBehaviour 


{ 
private int rotateCount; 
void Update () 
{ 
if (Input.GetKeyDown (KeyCode.R)) 
{ 
Animator animator = GetComponent<Animator> (); 
_rotateCount++; 
animator.SetTrigger ("RotateTrigger"); 
animator.SetInteger ("RotateCount", _rotateCount); 
} 
} 


Ce script permet de vérifier si l'utilisateur appuie sur la touche R grâce à la 
méthode statique GetKeyDown. Si c’est le cas, on récupère le composant 
Animator afin de déclencher le trigger nommé RotateTrigger et on 
change la valeur du paramètre RotateCount que l’on a incrémenté aupara- 
vant. 
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Lancez une dernière fois le jeu et appuyez sur R plusieurs fois. Au bout de 
la cinquième fois, l'animation ne devrait plus tourner car le paramètre Ro- 
tateCount passe à 5. Si vous gardez la fenêtre Animator visible lorsque 
vous testez votre application, vous pouvez voir ce que fait l'animateur en 
temps réel (animation courante, états des paramètres.….). 


3. Avatar 


3.1 Introduction 


L'animation de personnage est une chose très courante et le système d'anima- 
tion Mecanim se prête parfaitement à ce scénario. Unity traite différemment 
ce cas et permet de créer des animations pour des humanoïdes, définies par 
rapport à un squelette. Concrètement, chaque partie du corps doit être réfé- 
rencée en fonction d'une structure permettant de représenter les parties arti- 
culées du corps humain : c'est ce qu'on appelle un Avatar. 


HRemarque 


Dans notre exemple, nous utiliserons le modèle Ethan présent dans le dossier 
Assets\Standard Assets\Characters\ThirdPersonCharacter\ Models. Si ce ré- 
pertoire n'est pas présent, ajoutez-le à partir du menu Assets - Import 
Package - Characters puis cliquez sur Import. 
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3.2 Créer un avatar 


Sélectionnez le modèle Ethan puis affichez l'Inspector. 
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L'onglet Model propose différents paramètres d'importation au niveau des 
meshes ou des matériaux. 


Sélectionnez l'onglet Rig. 


Ce menu permet de définir le type des animations à importer grâce au para- 
mètre Animation Type. Notre modèle utilise le type Humanoïid, ce qui per- 
met la génération d'un Avatar par la suite. Les autres types d'animation 
possibles sont pour les animations standards. 


La propriété Avatar Definition permet de définir s'il faut créer les anima- 
tions à partir de ce modèle ou de copier les animations d'un autre modèle. 


Cliquez sur le bouton Configure afin de paramétrer l'Avatar qui doit être 
généré. 
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© Inspector 
# EthanAvatar 
v 


18: Chest 
Left Arm 
##) Shoulder 
(@) Upper Arm 
[O) Lower Aïm 
(#) Hand 
* Right Arm 
##; Shoulder 
(#) Upper Arm 
(@) Lower arm 
($} Hand 


aft 


La fenêtre est composée de deux onglets : Mapping et Muscles & Settings. 
Le premier est utilisé afin de lier chaque partie du modèle à une partie du sque- 
lette. La liaison peut être faite manuellement, ce qui peut être vite fastidieux, 
ou automatiquement grâce au menu Mapping. Le mode Automap va donc 
chercher lui-même à associer les bonnes parties ce qui permet de gagner beau- 
coup de temps. 
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DPour tester le mapping automatique, cliquez sur Mapping - Clear pour 
effacer toutes les liaisons puis cliquez sur Mapping - Automap, le sque- 
lette devrait alors retrouver l'intégralité de ses liaisons. 


Cliquez sur Muscles & Settings. 
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Cet écran permet de tester l'ensemble des mouvements possibles afin de les 
régler. Il est possible de tester un groupe de mouvement (comme l'ouverture 
et la fermeture de la main qui agit sur l'ensemble des doigts) ou sur un muscle 
spécifique (faire bouger une phalange). Si vous sélectionnez un muscle dans la 
liste, vous pouvez régler ses bornes, en définissant les limites du mouvement. 
Par exemple, il n'est pas possible de tourner la tête à 360°, des limites sont donc 
appliquées par défaut. 


Dans la partie Per-muscle Settings, cliquez sur Right Arm - Arm Twist 
In-Out. 


DEssayez de modifier les bornes puis testez l'animation en bougeant le slider 
de gauche. 


Inspector 


1 Paname Gpen Close 
FL] sement mme Left Right 
worms | Roll Left Right 


mens pommes 1 Out 

À sement jrs Rail In Out 

FE | eme pen Finger Open Close 
pont Pomme | F1 Qut 


# Left Finqurs. 

# Right Arm 
# Shoulder Down-Up 
# Shoulder Frent:Back 
# Arm Down-Un 
% Arm Front-Back 
# Arm Tnist In-Qut 

SD em 

# Forsarm Stretch 
+ Forearm Tist In-Out 
# Hand Down-Lp 
# Hand In-Out 

# Right Fingers 

3 Left Leg 

+ Right Leg 


Cliquez sur Done pour valider le comportement de l'avatar. 


Chapitre 8 
Le moteur physique 


1. Présentation du moteur physique 


Afin de rendre réaliste le comportement des objets dans une scène, il faut l'aide 
d'un moteur physique permettant d'appliquer la gravité, de calculer les colli- 
sions et plus simplement, d'appliquer une force. Tout cela est fourni de base 
dans Unity et s'applique aux objets grâce à des composants comme le Rigid- 
body ou le Collider. 


Il est donc possible de créer dans une scène de nombreux objets qui pourront 
réagir les uns avec les autres de façon réaliste. Bien entendu, chaque objet peut 
être contrôlé via un script afin de lui ajouter une force pour le mettre en mou- 
vement par exemple. 


Unity fonctionne avec deux moteurs physiques distincts, un pour la 3D et un 
autre pour la 2D. Leurs fonctionnements sont quasiment similaires, ils utili- 
sent seulement des composants différents (Rigidbody pour la 3D et 
Rigidbody2D pour la 2D). Cela est dû au fait que le nombre de dimensions 
à prendre en compte est différent, ce qui simplifie les calculs pour un jeu 2D, 
une dimension en moins étant à gérer. 


Pour bien comprendre comment fonctionnent les différents composants avec 
le moteur physique 3D, nous allons créer tout au long de ce chapitre des 
exemples d'utilisation de ceux-ci. 
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HRemarque 


Dans ce livre, nous ne traiterons que des composants utilisés pour le moteur 
physique 3D sachant que les différences sont minces entre les deux moteurs 
et les noms des composants sont faciles à retrouver pour la 2D,. 


2. Le composant Rigidbody 


2.1 Introduction 


Le Rigidbody est le composant de base afin d'activer le comportement du 
moteur physique à un objet. Une fois le composant ajouté à un GameObject, 
celui-ci devient influencé par la gravité ainsi que par les forces qui lui sont 
appliquées. 


2.2 La gravité 


Nous allons voir comment mettre en place la gravité, la paramétrer mais aussi 
la désactiver. 


Créez une nouvelle scène (File - New Scene). 


Dans la fenêtre Hierarchy, ajoutez une sphère à la scène (Create - 3D 
Object - Sphere). 
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Dans la fenêtre Inspector, ajoutez-lui le composant Rigidbody (Add 
Componant - Physics - Rigidbody). 


Le composant Rigidbody est donc paramétré par défaut pour avoir une 
masse (Mass) à 1 et pour être sensible à la gravité, la propriété Use Gravity 
étant cochée. Si vous lancez le jeu, vous devriez donc voir la sphère tomber à 
l'infini ce qui n'est pas le cas sans le composant Rigidbody. 


BOuvrez la fenêtre PhysicsManager à partir du menu Edit - Project 
Settings - Physics et inversez la gravité en modifiant la valeur de Gravity 
sur l'axe Y à 9.81, la valeur par défaut étant -9.81. 
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En relançant l'application, la sphère ne devrait plus être attirée vers le bas mais 
vers le haut. 


Remarque 
Attention, le changement de la gravité s'applique à l'ensemble des objets de 
la scène ! 


Pour que l'objet ne soit plus touché par la gravité, il suffit de décocher la case 
Use Gravity qui est activée par défaut. 
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Les forces 


À partir d'un Rigidbody, il est possible d'appliquer une ou plusieurs forces à 
l'objet. Ces forces correspondent par exemple au mouvement du bras lors- 
qu'on lance une balle. Il est très important de comprendre que l'utilisation des 
forces sur un objet modifie automatiquement les valeurs de Transform de 
celui-ci. Il ne faut donc en aucun cas ajouter des forces et modifier soi-même 
la position ou la rotation d'un objet. Cela provoquerait des erreurs lors des dif- 
férents calculs du moteur physique et provoquerait des dysfonctionnements. 


Lorsqu'un objet a un lien de parenté avec un autre, ce qui arrive très fréquem- 
ment, si un de ses parents bouge l'ensemble des enfants bougeront avec lui ain- 
si que les Rigidbody. 


Voyons ce qu'il se passe si l'on ajoute une force horizontale à la sphère précé- 
demment créée. 


DRemettez les valeurs de la gravité par défaut (-9.81 sur l'axe Y) si vous l'avez 
modifiée à l'étape précédente. 
DAjoutez un nouveau script à la sphère nommé AddForceBehavior (Add 


Component - New Script - Create and Add). Ce script va ajouter une 
force horizontale, une seule fois, à notre objet. 


using UnityEngine; 


public class AddForceBehavior : MonoBehaviour 


{ 
public Rigidbody rigidbody; 
private bool _firstLaunch; 


void Start () 


{ 


_firstLaunch = true; 
_rigidbody = GetComponent<Rigidbody> () ; 


} 


void FixedUpdate () 


{ 


if (_firstLaunch) 
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_firstLaunch = false; 
_rigidbody.AddForce (transform.right * 100); 


} 


DExécutez l'application. La sphère devrait donc avoir une trajectoire descen- 
dante (due à la gravité) sur la droite (due à l'ajout de la force). 


L'utilisation de la méthode AddForce permet d'ajouter une force linéaire. 
Pour ajouter une force de rotation à l'objet, il faut utiliser la méthode Add- 
Torque. 


Modifiez le script pour remplacer la ligne : 

H rigidbody.AddForce (transform.right * 100); 
par la ligne : 

H rigidbody.AddTorque (transform.up * 10); 


Sélectionnez la sphère et réexécutez l'application. Dans l'Inspector, la rota- 
tion sur l'axe Y devrait changer et la sphère tourner sur elle-même. 


BRemarque 


Le moteur physique permet de rajouter une force correspondant à la résis- 
tance de l'air. Il suffit de modifier la valeur des propriétés Drag et Angular Drag 
pour ajouter plus ou moins de résistance lors de l'ajout d'une Force ou d'un 
Torque. 


2.4 La cinématique 


Une option permet de ne plus prendre en compte le moteur physique : c'est la 
propriété isKinematic. En l'activant, l'objet devient entièrement contrô- 
lable à partir d'une animation ou la modification du Transform. Bien enten- 
du, les collisions ou les forces ne sont plus actives. Ceci est très utile pour 
désactiver la physique momentanément lors d'une mise en scène définie ou 
d'une animation. 
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. Le composant Collider 


Introduction 


Pour permettre à un objet de pouvoir rentrer en collision avec un autre, les 
deux objets doivent obligatoirement contenir un composant de type Col1i- 
der. Ce composant définit la forme de l'objet qui sera utilisé pour détecter les 
collisions. Totalement transparente, cette forme est très souvent une approxi- 
mation de l'objet pour des raisons de performance car plus la forme est simple, 
plus les calculs de détection de collisions le sont aussi. Il n'est pas nécessaire 
qu'elle soit parfaitement représentative de l'objet réel car cela ne provoque que 
très peu de changement au niveau de la jouabilité. 


3.2 Statique ou dynamique 


Chaque objet peut disposer d'un composant Collider, qu'il ait un Rigid- 
body ou non. On parle de static collider dans le cas où un objet ne possède pas 
de Rigidbody comme le sol ou un mur par exemple. Il est recommandé de 
ne pas modifier le Transform de cet objet car cela peut poser des problèmes 
de performance. Dans le cas où l'objet contient un Rigidbody, on parle de 
dynamic collider. Lorsque deux dynamic colliders entrent en collision, ils bou- 
geront tous les deux. Ce qui n'est pas le cas lors d'une collision entre un static 
collider et un dynamic collider car seul l'objet ayant un Rigidbody bougera. 


3.3 Les colliders primitifs 


3.3.1 


Unity met à disposition des colliders, dits primitifs, reposant sur des formes 
géométriques simples, ce qui permet des performances accrues. 


SphereCollider 


Ce composant permet de représenter une forme sphérique. Il est défini grâce 
aux propriétés Center et Radius. Le rayon (Radius) est obligatoirement le 
même sur les trois axes, il n'est pas possible de définir un rayon différent sur 
chacun des axes. 
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BoxCollider 


Ce composant permet de représenter une forme cubique. Il est défini grâce aux 
propriétés Center et Size. Contrairement au SphereCollider, il est pos- 
sible de définir une taille (Size) différente pour chacun des axes. Pour ajouter 
un collider pour un mur ou un sol, on utilisera ce type de collider. 


CapsuleCollider 


Ce composant permet de représenter une forme cubique coupée en deux avec 
une partie cylindrique en son centre. Il est défini grâce aux propriétés Center, 
Radius et Height. La hauteur (Height) permet de définir la taille de la partie 
cylindrique. Si la hauteur est à 0, la forme devient totalement sphérique. 
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3.4 Les colliders par composition 


Pour gagner en flexibilité tout en gardant strictement des colliders de type pri- 
mitif, il est possible de combiner plusieurs colliders au sein d'une hiérarchie 
d'objet. Lorsqu'un des objets enfants possédant un collider entre en collision 
avec un autre objet, l'objet parent et ses enfants en seront affectés. 
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Remarque 


Dans le cas d'une définition par composition, il faut ajouter un composant 
Rigidbody uniquement sur l'objet parent de la hiérarchie. 


3.5 Le MeshCollider 


Si les colliders primitifs ne vous suffisent plus, il est possible d'utiliser un 
MeshCollider utilisant un mesh pour définir plus en détail la forme 
géométrique que l'on souhaite. Grâce à ce composant, il est possible de définir 
comme on le souhaite le niveau de détail souhaité pour le collider. Il faut 

. garder à l'esprit que plus le mesh est complexe, plus les performances risquent 
d'être dégradées. 


Par défaut, si un MeshCollider entre en contact avec un autre collider du 
même type, rien ne se produira. Il faut activer la propriété Convex pour que le 
mesh soit généré comme étant "plein", ce qui permettra de gérer les collisions. 


3.6 Les matériaux physiques 


Chaque collider possède une propriété Material permettant de définir un 
matériau physique (PhysicMaterial et PhysicsMaterial2D). Celui-ci 
sert à représenter les caractéristiques physiques que peut avoir un matériau : 
la friction ou le rebondissement. 


Pour créer un nouveau matériau physique, il suffit d'aller dans le menu 
Assets - Create - Physic Material puis de le paramétrer à sa convenance. 
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Le réglage de la friction se fait au travers des propriétés Dynamic Friction et 
Static Friction dans le cas d'objets en mouvement ou non. Plus sa valeur est 
élevée, plus la friction est importante. Le rebondissement se paramètre grâce 
à la propriété Bounciness. Plus sa valeur est élevée, plus le rebond est impor- 
tant. 


Les événements 


Les déclencheurs 


Dans certains cas, il peut être utile d'utiliser le moteur physique afin de détec- 
ter une collision sans que celle-ci ne soit réellement effectuée entre les objets. 
C'est possible en activant la propriété Is Trigger de n'importe quel collider. 
Quand cette option est activée, l'objet ne sera pas traité comme solide, les 
autres objets pourront passer à travers, mais déclenchera un appel aux 
méthodes OnTriggerEnter,OnTriggerStayet OnTriggerExit sur les 
scripts attachés à cet objet. 


Les événements de script 


Lorsqu'une collision est détectée, plusieurs événements sont déclenchés dans 
chacun des scripts attachés à l'objet contenant le collider. Ils permettent par 
exemple de jouer un son, de changer une texture. Dans le cas d’une collision 
entre plusieurs objets possédant des colliders, les événements seront déclen- 
chés dans tous les scripts de chaque objet. 


269 


270 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Trois étapes de détection sont levées (ce sont les mêmes que lorsque l'on 
utilise les triggers) : 


- OnCollisionEnter : l'objet vient d'entrer en contact avec un autre. 


— OnCollisionStay : l'objet est entré en collision avec un objet et est 
toujours en contact avec lui. 


- OnCollisionExit : l'objet n'est plus en contact avec l'objet. 


Dans un script, les trois méthodes s'utilisent de cette manière : 
using UnityEngine; 


public class CollisionBehavior : MonoBehaviour 


{ 


void OnCollisionEnter (Collision collision) 


{ 


Debug.LogFormat ("Collision détectée avec l'objet '{0}'", 
collision.gameObject.name) ; 


} 


void OnCollisionStay(Collision collision) 


{ 


Debug.LogFormat ("Collision en cours avec l'objet '{0}'", 
collision.gameObject.name) ; 


} 


void OnCollisionExit (Collision collision) 


{ 
Debug.LogFormat ("Collision terminée avec l'objet '{0}'", 
collision.gameObject.name) ; 


HRemarque 


Le paramètre de type Collision que l'on retrouve dans l'ensemble des 
méthodes permet de donner des informations sur la collision comme les points 
de contact, l'objet en contact, etc. 
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3.8 Exemples de collision 


3.8.1 Entre un collider statique et un collider dynamique 


Dans cet exemple, nous allons voir le résultat d'une collision entre un objet 
contenant un static collider et un autre contenant un dynamic collider. 


Créez une nouvelle scène. 


DPositionnez l'objet Main Camera de cette façon : 


' 
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Dans la fenêtre Hierarchy, ajoutez une lumière directionnelle (Create - 
Light - Directional Light) afin d'éclairer la scène. 
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Dans la fenêtre Hierarchy, ajoutez un plan (Create - 3D Object - Plane) 
ayant un Scale de 10 sur les trois axes. 


DSupprimez le MeshCollider défini par défaut en cliquant sur 
Remove Componant. 


puis 


DAjoutez-lui un BoxCollider (Add Componant - Physics - Box Colli- 
der) ayant une taille (Size) de (10, 0.01, 10). 
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Dans la fenêtre Hierarchy, ajoutez une sphère (Create - 3D Object - 
Sphere) à la position (0, 3, O0). Vérifiez qu'elle dispose bien d'un 
SphereCollider. 


Ajoutez un composant Rigidbody (Add Componant - Physics - Rigid- 
body) à la sphère afin de la rendre dynamique. 


© Editions ENI - AI rights reserved 


175 


Le moteur physique 
Chapitre 8 


DExécutez le jeu. La sphère devrait tomber à cause de la gravité puis entrer en 
collision avec le plan servant de sol. Essayons maintenant de voir ce qu'il se 
passe si l'on ajoute un matériau physique à la sphère pour la faire rebondir. 


DDans la fenêtre Project, créez un matériau physique nommé Bounce (clic 
droit - Create - Physic Material) et ajustez les paramètres comme ci- 
dessous : 


276 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Sélectionnez le matériau Bounce créé précédemment et faites-le glisser sur 
la sphère dans la fenêtre Scene ou dans la Hierarchy. 


D fault-Materia 
Shader |. 


BRéexécutez le jeu. La sphère devrait tomber puis rebondir plusieurs fois sur 
le plan puis s'arrêter. 


3.8.2 Entre des colliders dynamiques 


Dans cet exemple, nous allons voir le comportement de deux sphères, ayant 
un dynamic collider, entrant en collision. Par souci de simplification, nous 
repartirons de l'exemple précédent (section Entre un collideur statique et un 
collider dynamique). 


Dans la fenêtre Hierarchy, ajoutez une sphère (Create - 3D Object - 
Sphere) nommée BigSphere à la position (0.25, 1, O) et d'une taille de 2. 
Vérifiez qu'elle dispose bien d'un SphereCollider ayant 0.5 de rayon. 
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Ajoutez à la sphère BigSphere un composant Rigidbody (Add Compo- 
nant - Physics - Rigidbody). 
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DExécutez le jeu. La petite sphère devrait rebondir sur la grosse sphère les 
repoussant toutes les deux dans une direction opposée. L'objet BigSphere 
se déplace plus lentement car le moteur prend en compte sa taille et sa 
masse par rapport à la plus petite sphère lors de la collision. 


Changez la valeur de la masse (Mass) de BigSphere pour la rendre plus 
lourde (10). 


DSi vous réexécutez le jeu, la grosse sphère ne devrait pratiquement pas 
bouger lors de la collision. 


4. Les composants Joints 


4.1 Introduction 


Pour assembler un objet avec un autre, Unity fournit des composants permet- 
tant de mimer des joints de différentes sortes. Il va donc être possible de lier 
un objet statique, comme un plafond, pour lui fixer un objet dynamique, 
comme une lampe suspendue. Cette lampe pourra donc se balancer librement 
grâce à l'ajout d'un composant permettant de définir la liaison entre les deux 
objets (axes de rotation...). 
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4.2 FixedJoint 


Le composant FixedJoint permet de contraindre le mouvement d'un objet 
par rapport à un autre. Concrètement, cela revient à la même chose que 
l'assemblage de deux objets en utilisant un lien de parenté (parent - fils). 
Néanmoins, il est plus facile de déconnecter la jointure via le FixedJoint et 
la propriété Connected Body plutôt que de refaire la hiérarchie des objets. 
Mais la grande force du composant est de pouvoir définir une force de rupture 
(Break Force et Break Torque) à partir de laquelle la liaison est brisée. 


4.3 SpringJoint 


Le composant SpringJoint permet de définir une liaison de type ressort. 
De la même manière que le FixedJoint, les deux objets sont liés mais une 
certaine distance entre les deux est tolérée. 


La propriété Spring permet de régler la force du ressort tandis que la propriété 
Damper règle la valeur de l'amortissement. Plus le nombre est grand, plus le 
ressort devient rigide. 


Min Distance et Max Distance permettent de paramétrer les distances 
minimale et maximale à partir desquelles le ressort n'appliquera plus de force. 
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HRemarque 


Comme le composant FixedJoint, il est possible de paramétrer des forces 
de rupture de liaison. 


4.4 HingeJoint 


Le composant HingeJoint permet de définir une liaison de type charnière 
ou articulaire, ce qui convient parfaitement pour les portes ou les éléments 
suspendus. Il reprend également les caractéristiques du SpringJoint 
adapté pour un mouvement de rotation. 


Une nouvelle caractéristique permet de simuler un moteur (Motor) en défi- 
nissant sa force (Force) ainsi que sa vitesse de rotation (Target Velocity). 
L'option Free Spin est utilisée si l'on veut que le moteur soit utilisé unique- 
ment pour accélérer le mouvement et jamais pour le ralentir. 


La définition de limites (Limits Min et Limits Max) permet de bloquer les 
mouvements de rotation à des angles donnés. 
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4.5 CharacterJoint 


Le composant CharacterJoint permet de définir une liaison de type 
rotule, c’est-à-dire qu'il est possible de contrôler séparément chacun des trois 
axes. 


Pour configurer une liaison, il faut spécifier un axe principal appelé Twist 
Axis, représenté par le gizmo orange et nommé Axis dans l’Inspector. 
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Ses limites de rotation sont configurables grâce aux propriétés Low Twist 
Limit - Limit et High Twist Limit - Limit. Le second axe (représenté par le 
gizmo vert) est appelé Swing 1 et est perpendiculaire au Twist Axis. Le troi- 
sième axe (n'ayant aucun gizmo) est appelé Swing 2 et est perpendiculaire 
aux deux autres axes. Il est possible de définir des limites sur chacun des trois 
axes. 


Le Twist Axis est le seul axe pouvant être paramétré comme étant de type 
ressort, grâce aux propriétés Swing Limit Spring, il est donc important de 
bien le définir. 
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4.6 ConfigurableJoint 


Si aucun des autres joints ne vous permet de faire ce que vous souhaitez faire, 
le composant ConfigurableJoint est là pour vous. Il regroupe toutes les 
possibilités de chaque joint comme la définition de limites, l'effet ressort, le 
moteur, les rotations sur tous les axes ou encore la force de rupture. 


Chaque axe se configure de façon complètement indépendante de façon à 
pouvoir le bloquer entièrement, lui imposer des limites ou le laisser libre. 
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Remarque 


Ce type de liaison peut s'avérer très difficile à gérer à cause du nombre impor- 
tant de paramètres. Il est recommandé de le choisir uniquement si aucun 
autre type de joint n'est utilisable. 
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1. Présentation générale 


1.1 Définition 


Lors du développement d'un logiciel 2D/3D, il est commun de distinguer la 
scène immersive en plusieurs dimensions de l'interface graphique permettant 
d'accéder à celle-ci. Dans le monde du jeu vidéo, on distingue par exemple le 
"jeu" du "menu". 


On va donc parler d'interface graphique pour désigner tous les éléments per- 
mettant de naviguer au sein des scènes multidimensionnelles ou d'afficher des 
informations à l'utilisateur. 


La création d'un menu efficace à l'aide d'un éditeur dédié à la manipulation 
d'objets dans des repères à plusieurs dimensions peut être assez fastidieux car 
l'outil n'est tout simplement pas optimisé pour cette tâche. 
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Un peu d'histoire 


Unity propose depuis ses premières versions un système de création d'inter- 
faces graphiques qu'il est possible de trouver sous le nom "Legacy GUI". 


Comme nous l'avons déjà vu dans un chapitre précédent, dans ce cadre, la 
création des éléments se fait de façon programmatique dans la méthode 
OnGUI du code d'un script. Voici un exemple dessinant un bouton et testant 
s'il a été cliqué par l'utilisateur : 

private void OnGUI() 


{ 


if (GUI.Button(new Rect (10, 10, 150, 42), "mon bouton exemple")) 


Debug.Log ("Bouton cliqué"); 


} 


La création de l'interface graphique bien que facilitée peut devenir assez com- 
plexe à mettre en œuvre car le code contient à la fois la définition des éléments 
graphiques et à la fois les différentes actions liées (le code à exécuter en cas de 
"succès" du clic par exemple). De plus, il est nécessaire de lancer l'exécution 
dans l'éditeur ou sur un périphérique pour visualiser concrètement le résultat 
du code écrit. 


Ce système est utilisé par l'éditeur lui-même et peut être utilisé pour dessiner 
des éléments d'interfaces au sein de l'éditeur. 


Cette façon de créer une interface n'étant pas des plus pratiques, une multi- 
tude de plugins sont apparus sur l'Asset Store d'Unity pour proposer leur 
propre solution plus adaptée et simple d'utilisation. 


Le nouveau système d'Ul 


Cela n'est pas passé inaperçu et Unity a décidé de travailler sur sa propre ver- 
sion en embauchant le créateur du plugin le plus populaire (nGUI) Michael 
Lyashenko. Ce nouveau système appelé "Unity Ul" est disponible depuis la 
version 4.6 d'Unity et c'est à lui que nous allons nous intéresser. 


Avec UnityUT, même s'il est possible de passer par du code, le travail se fait 
usuellement depuis l'éditeur à l'aide de scripts posés sur des GameObijects. 
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. Le système de Canvas 


Définition 


Un Canvas est l'élément racine de toute interface graphique. Il est obligatoire 
et tous les éléments graphiques sont nécessairement à l'intérieur d'un Canvas. 
Lorsque vous ajoutez un élément d'interface graphique sans qu'un canvas soit 
déjà présent, Unity en créera un pour vous. Le Canvas sera alors la surface de 
rendu de votre interface graphique qui se comportera alors comme si elle était 
dans un monde 2D uniquement. 


L'ajout d'un Canvas est fait de cette manière dans l'éditeur : 


Dans l'onglet Hierarchy, sélectionnez Create, puis UI puis Canvas. 


Create Empty 
Create Empty Child 
3D Object 

2D Object 

Light 

Audio 


Panel 
Particle System Button 


Camera Text 
Image 
Raw Image 
Slider 
Scrollbar 
Toggle 
Input Field 


Le Canvas est maintenant ajouté dans la scène et sélectionné. Renommez- 
le [UI] MainCanvas. 
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Qu'il soit sélectionné ou non, un Canvas est toujours visible dans la vue Scene 
sous la forme d'un rectangle. 


Ajoutons maintenant un bouton à ce Canvas (nous étudierons en détail ce 
composant plus tard) : 


DEffectuez un clic droit sur le Canvas et sélectionnez UI puis Button. 


LUI M 


Copy 
Paste 


Rename 


Duplicate 
Delete 


Select Frefals 


Create Empty : Tet 


3D Object > es 
es a 4 Raw Image 
pa à Slider 
med Scrollbar 


Particle System 
Camera 


Toggle 
Input Field 
Canvas 

Event System 
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Vous venez d'afficher votre premier bouton dans la nouvelle interface gra- 
phique d'Unity ! 


2.2 Nombre de Canvas dans une scène 


Il est possible d'ajouter autant de Canvas que voulu dans une scène, chacun 
avec une configuration différente si nécessaire. Il est aussi possible d'imbriquer 
des Canvas les uns dans les autres. 


L'intérêt de cette solution est d'avoir de meilleures performances : la modifica- 
tion d'un élément d'UI d'un Canvas déclenche le rendu de tous les éléments du 
Canvas. Ainsi en groupant les éléments d'UI par Canvas, on réduit la charge 
de redessinage à chaque modification. 


2.3 Les différents modes de rendu 


La propriété Render Mode du Canvas permet de configurer la manière dont 
le Canvas et ses éléments sont affichés dans le monde réel de la scène. Il existe 
trois valeurs possibles. 


2.3.1 Par défaut : Screen Space - Overlay 


Il s'agit de la valeur par défaut qui signifie que l'UI va être dessinée par-dessus 
la scène. Peu importe la taille de l'écran, le Canvas aura toujours la même taille. 
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Si l'écran est redimensionné, le Canvas le sera aussi pour suivre ce change- 
ment. 


Le Canvas n'est attaché à aucune caméra et son rendu sera toujours affiché. 
L'emplacement du Canvas dans la scène (comme vous pouvez le voir dans la 
capture d'écran) n'a que peu d'importance. 


remarque 
Une manière aisée de tester cela consiste à passer l'éditeur en mode Free 


Aspect et de changer la taille de l'onglet Game. 
Screen Space - Camera 


Dans ce mode de rendu, très similaire au précédent, l'UI est affichée au travers 
d'une caméra. Le Canvas est toujours redimensionné pour correspondre au 
frustrum de la caméra. 


L'Inspector du Canvas va ainsi proposer deux propriétés supplémentaires : 


— Render Camera : choisissez ici la caméra effectuant le rendu du Canvas. 


< Plane Distance : définissez avec cette propriété la distance du Canvas par 
rapport à la caméra. 


© Editions ENI - AII rights reserved 


291 


: Unity Ul ef interfaces utilisateurs 
Chapitre 9 


L'UI faisant partie de la scène de la caméra, les propriétés de profondeur 
impactent l'affichage de la scène et des éléments du jeu plus proche de la camé- 
ra que le Canvas l'occulteront. En voici un exemple : 
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2.3.3 World Space 


Dans ce mode, le Canvas est affiché dans la scène comme s'il était un "plan". 
Cette fois-ci, c'est au développeur de choisir la taille qu'il souhaite donner au 
Canvas tout en gardant en tête que la taille visible dépendra de la distance du 
Canvas par rapport à la caméra. 


L'intérêt évident de ce mode est de mettre en place des éléments d'interface 
graphique directement dans la scène du jeu comme s'ils en faisaient partie. 


2.4 Adaptation du rendu à la taille de l'écran 


Un autre script va aider à définir le rendu fait d'un Canvas : le CanvasScaler. 
Celui-ci est ajouté par défaut par Unity et il est possible de configurer le mode 
de redimensionnement du Canvas avec la propriété Ui Scale Mode. Il existe 
trois modes différents : Constant Pixel Size, Constant Physical Size et 
Scale With Screen Size. 


Remarque 


Attention, si le Canvas à comme mode World Space, il n'est pas possible de 
changer cette propriété car cela n'a pas de sens. En effet, celui-ci est affiché 
dans la scène, dans le rendu fait par la caméra principale qui affiche le Can- 
vas par rapport à sa propre configuration. 
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2.4.1 Par défaut : Constant Pixel Size 


Dans ce mode, les éléments sont dimensionnés avec des tailles en pixels qui ne 
varient pas. Il est possible d'appliquer un ratio "scale" pour agrandir/diminuer 
les éléments en utilisant la propriété Scale Factor. 


{Script} 


2.4.2 Constant Physical Size 


Ce mode permet de dimensionner les éléments en utilisant des unités de 
mesure physiques réelles en lieu et place des pixels. Cela est très pratique dans 
un simulateur par exemple, si vous souhaitez faire un rendu d'un élément 


physique. 
Bien sûr, toute la magie du mécanisme repose sur le fait que le périphérique 


d'affichage retourne la bonne valeur de sa densité de pixel et il est possible d'en 
spécifier une valeur par défaut. 


2.4.3 Scale With Screen Size 


Dans ce mode, l'UI va se dessiner dans un Canvas possédant une résolution de 
référence et le CanvasScaler va l'agrandir ou le réduire en fonction de la 
taille réelle disponible pour le Canvas. Si moins de place est disponible, les élé- 
ments seront plus petits et inversement ils seront plus gros s'il y a plus de place 
disponible. 
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Dans le cas où le ratio réel de l'écran n'est pas le même que la résolution de 
référence, le CanvasScaler va devoir décider d'un axe où il ne suivra pas la 
référence afin de conserver le ratio de l'écran. Ce choix est contrôlé par la pro- 
priété Screen Match Mode et le curseur Match disponible dans l'Inspector : 


En choisissant Match Width Or Height, le CanvasScaler va s'acharner à 
respecter soit la hauteur, soit la largeur de référence selon le ratio Match défi- 
ni. 


Prenons pour exemple une résolution d'écran de 1920x1080 (Full HD) ayant 
un ratio de 16:9 et une référence de résolution de 200x200. 


— Si Match est défini à 0 (Width), alors le Canvas aura une taille de 200x112 : 
la largeur et le ratio de 16:9 sont respectés. Pour appliquer cela, il faut diviser 
la largeur réelle (1920) par 9,6. 


— Si Match est défini à 1 (Height), alors le Canvas aura une taille de 355x200 : 
la largeur et le ratio de 16:9 sont respectés. Pour appliquer cela, il faut diviser 
la hauteur réelle (1080) par 5,4. 


— Si Match est défini à 0,5 alors le Canvas aura une taille de 266x149 : le ratio 
de 16:9 est respecté. Cependant, pour déduire la taille du Canvas, il faut ap- 
pliquer une moyenne logarithmique entre les deux ratios (9,6 et 5,4) obte- 
nus précédemment. 


Il devient vite préférable pour nos neurones de laisser Unity faire ce calcul et 
de retenir que ce paramètre permet de pondérer quel axe est utilisé pour res- 
pecter le ratio de l'écran et la résolution de référence. La valeur de 0,5 est un 
bon compromis utilisé dans la plupart des cas. 
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355 


Match = 1 200 


Les deux autres valeurs de Screen Match Mode sont Expand et Shrink : 
dans le premier cas, le Canvas sera étendu pour être toujours au moins de la 
taille de la résolution de référence et dans le second cas, il sera réduit pour être 
au maximum de la taille de la résolution de référence. Ces deux options sont 
surtout pratiques lorsque vous voulez afficher une image couvrant toute la 
place disponible. 


Le système de positionnement et d'ancrage 


Le composant RectTransform 


Alors que les éléments de la scène portent un script de type Transform pour 
être positionnés, les éléments d'UI utilisent un script de type RectTrans- 
form. Lorsque vous ajoutez un élément graphique, ce script est automatique- 
ment ajouté et l'Inspector modifie son affichage de façon à afficher le 
RectTransform à la place du Transforn : 
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Un RectTransform permet de définir la position et la taille d'un élément 
d'UT sur sa zone de rendu 2D. La manière la plus aisée de procéder est de passer 
l'éditeur dans le mode "redimensionnement" et d'utiliser la souris pour placer 
les éléments correctement. Pensez de même à paramétrer la vue en Pivot et 
en Local pour des manipulations aisées. 


Remarque 


Astuce à connaître : maintenez la touche (Shift) enfoncée pendant vos redi- 
mensionnements pour conserver le ratio des éléments. 


Vous remarquerez aussi dans l'Inspector qu'il est possible d'affecter des pro- 
priétés liées à sa position dans une scène 8D : position sur l'axe Z (par rapport 
au plan de rendu), rotation et redimensionnement sur les trois axes. 


Attention cependant, dans le cas d'un composant d'UI, modifier les valeurs de 
Scale a pour impact de "zoomer" réellement l'élément : les images, polices et 
autres contenus seront étirés et pourront apparaître de façon dégradée si 
l'agrandissement est trop élevé. 
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3.2 Le système d'ancrage 


3.2.1 Définition 


La position d'un élément d'UI est définie par rapport à des ancres qui définis- 
sent une zone d'ancrage. Celle-ci correspond à un rectangle lui-même spécifié 
par deux points. Unity appelle ces deux points les points minimum et maxi- 
mum. La zone d'ancrage est représentée dans l'éditeur par quatre petits 
triangles blanc. Elle peut être réduite à un point unique si nécessaire. 


Les coordonnées de ces ancres sont toujours exprimées en pourcentage par 
rapport au point inférieur gauche du RectTransform parent. Si ce dernier 
change de taille (via le code, ou à la main dans l'éditeur, la position réelle des 
ancres va ainsi être modifiée bien que les coordonnées "configurées" ne varie- 
ront pas. 


Pour rappel, n éléments d'UI auront toujours un RectTransform parent 
(directement ou dans sa hiérarchie) et le plus haut sera nécessairement un 
Canvas. Les ancres d'un Canvas apparaissent grisées dans l'Inspector et ne 
sont pas modifiables. Elles sont en effet calculées automatiquement par le 
CanvasScaler en fonction de sa configuration. 
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À titre d'exemple, il est possible de configurer les ancres pour que la zone 
d'ancrage soit centrée par rapport à son RectTransform parent en prenant 
un tiers de sa taille en largeur et en hauteur. 


RectTransform parent 


Zone d'ancrage 66% 


33% 


Pour cette configuration, les coordonnées des ancres seront donc (0.33, 0.33) 
et (0.66, 0.66). Pour cela, il faut suivre la procédure suivante : 


Sélectionnez l'élément d'UI dans l'onglet Hierarchy. 


Dans l'Inspector, saisissez les bonnes coordonnées pour les points minimum 
et maximum. 


Assurez-vous que les valeurs de Left, Top, Right et Bottom sont bien à 
Zéro. 
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Remarque 


Ilest tout à fait possible de mettre des valeurs négatives pour "sortir" du Rect- 
Transform parent. 


3.2.2 Valeurs prédéfinies 


Suite à cette dernière modification, l'Inspector affiche en haut à gauche du 
RectTransform trois carrés imbriqués avec le texte "custom" apparaissant 
sur les côtés supérieur et gauche du plus grand carré. Cette zone représente la 
configuration des ancres. En cliquant sur cette zone, Unity vous propose une 
matrice des valeurs d'ancrage les plus courantes. 


Cette aide est très utile car elle représente de façon visuelle le résultat produit 
par une configuration choisie. Une fois une de celles-ci choisie, l'Inspector se 
met à jour pour utiliser l'icône correspondante. Aussi, vous remarquerez qu'en 
changeant les ancres par ce biais, l'élément d'UI n'est jamais déplacé : Unity 
corrige automatiquement les coordonnées pour vous. 
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3.3 Positionnement et dimensionnement de l'élément 


3.3.1 


Maintenant que nous avons un RectTransform avec des ancres configurées 
il est nécessaire de définir la position de l'élément. Dans certains cas, il est pos- 
sible que ces valeurs soient grisées et non modifiables. Cela se produit lorsque 
celles-ci sont calculées par un autre composant (CanvasScaler ou des 
layouts abordés plus tard dans ce chapitre). 


Remarque 


Astuce : il est possible de tester l'impact d'un redimensionnement du parent en 
gardant l'élément courant sélectionné et en jouant sur les dimensions du pa- 
rent avec la souris (l'icône à double flèche apparaît lorsque cela est possible). 
Le texte Preview apparaît alors dans l'éditeur et au relâchement de la souris, 
l'élément parent reprendra sa dimension d'origine. 


En fonction du choix de positionnement des ancres, des valeurs différentes 
peuvent être définies. 
La zone d'ancrage est un point 


Cette situation se produit lorsque les coordonnées des deux ancres sont égales. 
Dans ce cas, il est possible de définir deux éléments dans l'Inspector : 


— la hauteur et la largeur de l'élément, 


— la position du centre de l'élément d'UI par rapport au point d'ancrage. Ces 
valeurs peuvent être négatives. 


Pour avoir un bouton de 200 pixels de large et de 100 pixels de haut, centré 
verticalement et décalé de la moitié de sa taille sur la droite, il faut reproduire 
cette configuration : 
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Il est important de remarquer que dans cette configuration, il est tout à fait 
possible que le bouton sorte de la zone visible à l'utilisateur. Il suffit par 
exemple que la zone de rendu ait une taille inférieure à 400 pixels. 


3.3.2 La zone d'ancrage est une ligne verticale ou horizontale 


Cette situation se produit dans le cas où deux coordonnées des points 
d'ancrage sont égales sur le même axe. Dans ce cas, il est possible de modifier 
ces valeurs dans l'Inspector : 


— La dimension (largeur ou hauteur) sur l'axe où les coordonnées sont égales. 


— La distance par rapport aux ancres sur l'autre axe. La distance par rapport au 
point "Minimum" (Top) et par rapport au point "Maximum" (Bottom) 
dans le cas d'une ligne verticale par exemple. Il est aussi possible de repré- 
senter ces valeurs comme la distance par rapport aux bords de la zone d'an- 
crage. Ces valeurs peuvent être négatives ou égales à 0 si l'on souhaite que 
l'élément colle aux ancres. 


Il est par exemple possible de configurer un bouton pour avoir toujours une 
largeur de 200 pixels, être décalé de 100 pixels sur la droite mais d'être toujours 
centré verticalement en prenant 60 % de la hauteur de son parent. Pour cela 
on configure l’ancre Min Y à 0,2 et l’ancre Max Y à 0,8. 


Dans cette configuration, le bouton ne sortira jamais de l'écran sur le haut ou 
le bas mais il est possible qu'il devienne si petit en hauteur que le texte à 
l'intérieur devienne tronqué ou invisible. 
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3.3.3 La zone d'ancrage est un rectangle 


Cette situation se produit si toutes les coordonnées des points d'ancrage sont 
P P 8 
différentes. Dans cette situation, l'éditeur permet de modifier la distance à 
, P 
gauche, à droite, en haut et en bas par rapport à la zone d'ancrage. Ces valeurs 
peuvent être négatives ou égales à zéro si l'on veut que l'élément colle son 
RectTransform parent. 


Il est ainsi par exemple possible de configurer un bouton pour que celui-ci 
prenne 60 % de l'espace horizontal et 80 % de l'espace vertical de son parent 
en reproduisant cette configuration : Min X à 0,2, Max X à 0,8, Min Y à 0,1 
et Max Y à 0,9. 


© Inspector 


Dans cette configuration le bouton ne sortira jamais de son parent mais son 
contenu peut être tronqué ou invisible. 
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3.3.4 Schéma récapitulatif des positionnements 


Voici un schéma récapitulant les différentes configurations possibles : 


RectTransform parent 


Zone d'ancrage 


3.4 Comportement de l'éditeur 


Par défaut, lorsque vous modifiez dans l'Inspector les différentes valeurs liées 
à l'ancrage d'un composant d'UI, l'éditeur va mettre à jour automatiquement 
les différentes valeurs de positionnement pour que l'élément ne change pas de 
place. 


Par exemple, en passant d'un ancrage centré sur un point à un ancrage corres- 
pondant à un rectangle, l'élément va voir sa largeur et sa longueur transfor- 
mées en des valeurs Top/Bottom/Left/Right correspondantes. 


Il est possible de changer ce comportement et passer dans le mode "données 
brutes" en cliquant sur l'icône R de l'Inspector. Dans cet état, une modifica- 
tion des valeurs d'ancrage n'impacte pas les valeurs des positionnements. 
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4. Les différents éléments d'affichage 


Unity propose plus d'une dizaine de composants différents d'affichage. 
Certains sont des scripts simples et d'autres sont des compositions d'éléments 
de base. 


4.1 Text : afficher un texte 


Il s'agit du composant de base permettant d'afficher un texte simple ou riche 
et de le mettre en forme. Sa propriété principale est évidemment Text qui per- 
met de définir le texte à afficher. Il est possible de choisir la couleur d'affichage 
en utilisant la propriété Color dans l'Inspector ou le code. 


4.1.1 Configuration de l'affichage des lettres 


Le groupe Character dans l'Inspector permet de choisir la police à utiliser et 
sa configuration générale : 


— Font : police d'affichage. 
— Font Style : style du texte (normal, gras, italique ou les deux). 
— Font Size : taille (en pixel) d'affichage du texte. 


— Line Spacing : valeur d'interlignage. Cela est pratique pour rapprocher les 
unes des autres les lignes d'un paragraphe. 
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Nous verrons plus tard le rôle de la case à cocher Rich Text. 


4.1.2 Configuration de la disposition 


Le groupe Paragraph permet de configurer la disposition du texte par rapport 
à son RectTransform parent : 
- Alignment : alignement vertical et horizontal du texte. 


— Horizontal overflow : comportement du texte lorsque sa taille ne tient 
pas horizontalement : sortie de l'élément (Overflow) ou passage à la ligne 
(wrap). 

— Vertical overflow : comportement du texte lorsque sa taille ne tient pas 
verticalement : sortie de l'élément (Overflow) ou coupure (Truncate). 


— Best fit : en cochant cette case, la taille de la police sera ignorée et Unity 
adaptera au mieux la taille de la police pour afficher tout le texte. En co- 
chant cette case, deux champs apparaissent alors pour spécifier les valeurs 
minimum et maximum de taille de police. 


4.1.3 Utilisation de texte riche 


En cochant la case Rich Text, il est possible d'utiliser un système de balisage 
pour mettre en forme plus précisément le texte. Les valeurs renseignées sur le 
composant seront utilisées sauf là où les balises imposeront une différence. 


Voici une liste des balises disponibles pour modifier l'affichage : 


— <b> : le texte encadré sera en gras. 

— <i> :le texte encadré sera en italique. 

- <size»> : définit la taille du texte encadré. 

— <color> : définit une couleur d'affichage. 

Il est bien sûr possible de combiner et d'imbriquer plusieurs balises ensemble. 


Vous remarquerez la syntaxe permettant d'assigner les valeurs des balises et 
plus précisément sur la balise color dans cet exemple : 


Je suis du texte <b>plus</b> ou <i>moins</i> long qui est affiché 
avec la police Arial en <b><color-Hffffff-blanc</color></b>. 
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L'affichage produit sera le suivant : 


| Oïnspector 


de suis du texte <b>plus</b> où <i>moin 
qui est affiché avec la police Arial en 
<b><color=#ffffff-blanc</color»< 


Utilisation via un script 


La modification via un script du texte se fait très simplement en changeant la 
valeur de la propriété text du composant Text précédemment obtenu. Voici 
un exemple changeant le texte dans un script posé sur le même GameObiject 
que l'élément Text et remplaçant ainsi la valeur renseignée dans l'éditeur : 


var textComponent = GetComponent<UnityEngine.UI.Text>(); 
textComponent .text = 
“Un texte avec" + Environment.NewLine + "un saut de ligne."; 


Rawimage : afficher une texture 


Description du composant 


Ce composant permet d'afficher n'importe quel type de texture dans l'UI. Du 
fait de son caractère générique, ce composant ne possède pas beaucoup de 
configurations possibles : 


— Texture : la texture à afficher. 

— Color : la couleur à appliquer à l'image. 

— Material : le matériel d'affichage (peut être laissé vide). 

— UV Rect : permet de définir une portion de l'image à afficher. 
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Cette dernière propriété est particulièrement utile car elle permet de placer 
plusieurs "images" dans une même texture et de choisir un rectangle ayant 
comme origine le bord inférieur gauche de l'image correspondant à la portion 
à afficher. Les tailles sont exprimées en pourcentage par rapport à la texture. 
Voici un exemple de configuration affichant la partie supérieure droite d'une 
texture. 


Remarque 


Attention à vos performances : comme une texture est utilisée, chaque ajout 
d'un composant RawImage provoque potentiellement une demande de ren- 
du (draw call) supplémentaire. 


4.2.2 Utilisation via un script 


Pour changer ou assigner une texture via un script, il suffit de modifier la 
valeur de la propriété texture. Voici un exemple lisant une image depuis le 
dossier Resources d'Unity : 


private void ChangeTexture () 


{ 


//Récupération du composant 
var rawlmage = GetComponent<UnityEngine.UI.RawImage»> () ; 
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//Chargement d'une texture depuis les ressources 
var texture = (Texture2D)Resources.Load("CustomAsset"); 


// Assignation de la nouvelle texture 
rawimage.texture = texture; 


} 


Une méthode supplémentaire SetNativeSize est présente sur le compo- 
sant RawImage et permet de modifier la taille du RectTransform associé 
pour qu'il prenne les dimensions exactes de la texture chargée (ou les dimen- 
sions de la portion d'image si des valeurs sont configurées dans les champs UV 
Rect). 


Image : afficher un sprite 


Ce composant permet lui aussi d'afficher une image mais uniquement si elle 
est importée en tant que sprite. En contrepartie, il propose plus de possibilités 
en termes d'affichage et d'animations. Sa propriété principale est Source 
Image permettant de choisir le sprite à utiliser. 


Types d'affichage 


La propriété Image Type permet de choisir parmi différents types d'affichage 
une fois l'image source assignée dans l'éditeur : 


— Simple : l'image est affichée basiquement pour remplir son RectTrans- 
form parent. 


— Sliced : dans ce cas, l'image remplit son RectTransform parent sans que 
la bordure définie dans l'éditeur de sprite abordé dans un précédent chapitre 
ne change de taille. Cela est notamment pratique pour mettre en place un 
bouton ayant une bordure affichée correctement et un "contenu" pouvant 
s'étirer telle une couleur unie. 


— Tiled : dans ce cas, l'image conserve sa taille native et un maillage est consti- 
tué pour remplir au mieux le RectTransform parent. 


— Filled : dans ce cas, l'image remplit son RectTrans£form parent en fonc- 
tion du taux et du mode de remplissage choisi. 
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Voici un exemple d'affichage dans le choix Tiled : 


: Filled 


Remarque 


Dans les configurations Simple ou Filled, une case à cocher Preserve Aspect 
permet d'indiquer à Unity de conserver l'aspect de l'image dans sa zone 
d'affichage. Ainsi même si le ratio du RectTransform n'est pas Lg de 
l'image, celle-ci sera affichée correctement. 


4.3.2 Utilisation du mode Filled 


Le type d'image Filled permet de choisir le type de remplissage souhaité : 
vertical, horizontal ou radial. La valeur Fill Amount correspond alors au 
pourcentage de remplissage souhaité. 


Par exemple, si l'on veut qu'une image soit affichée radialement à 80 %, il 
faudra utiliser cette configuration : 
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Une fois couplé au système d'animation d'Unity, il est alors rapide de mettre 
en place des animations de chronomètre, d'horloge, de ] jauge se remplissant 
(avec un mode de remplissage horizontal). etc. 


Utilisation via un script 


Ces configurations sont toutes accessibles depuis un script sous la forme d'une 
. . r . 
propriété et changer une image à la volée est un jeu d'enfant : 


public Spritel] Sprites; 
void Start () { 
var image = GetComponent<UnityEngine.UI.Image» (); 


// Assignation de l'image 
image.sprite = Sprites{1l; 


Button : afficher un bouton pour réagir au clic 


Ce composant permet d'afficher un bouton. Il s'agit donc d'un élément 
capable de déclencher un événement lorsque l'utilisateur clique dessus (avec 
une souris, son doigt, un clavier, etc.). Un bouton correspondra, par défaut 
dans Unity, en un GameObject contenant un script Button (Script), un 
script Image (Script) et un sous-GameObject optionnel contenant un texte. 


Unity propose une image standard comme valeur par défaut pour l'affichage 
d'un bouton. Cette image peut être remplacée par celle de votre choix. 


Un bouton peut être dans un état activé (Interactable dans l'Inspector) ou 
désactivé. S'il est désactivé, il restera visible dans la scène mais les interactions 
de l'utilisateur n'auront pas d'effet sur lui. 


© Editions ENI - All rights reserved 


311 


Unity Ul et interfaces utilisateurs 
Chapitre 9 


Button * 


4.4.1 Les différents états visuels 


Un composant bouton peut aussi être considéré comme une machine à états 
possédant ces différentes valeurs : 


— Highlighted : l'utilisateur s'intéresse à ce bouton. Par exemple, avec une 
souris, cet état est activé lorsque l'utilisateur place sa souris sur le bouton. 
Cela est aussi Le cas lorsque ce contrôle est sélectionné au clavier par l'utili- 
sateur. 


— Pressed : l'utilisateur appuie sur le bouton. 
— Disabled : le bouton est désactivé/inactif. 


— Normal : dans tous les autres cas, le bouton est dans un état d'attente d'une 
interaction de l'utilisateur. 
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Pour chacun de ces cas, Unity permet de faire correspondre un affichage visuel 
différent. Cela peut être fait de plusieurs manières selon la configuration de la 
propriété Transition de l'Inspector : 


— Color Tint : la teinte de l'image spécifiée par la propriété Target Graphic 
est modifiée en fonction de l'état. Ce type de transition est simple à mettre 
en place mais ne permet pas une grande latitude en termes d'affichage car le 
sprite dans son entier change de couleur. Dans cette configuration, il est 
aussi possible de configurer la durée de l'animation de changement de cou- 
leur via la propriété Fade Duration par défaut à 0.1. 


— Sprite swap : pour chaque état visuel correspond un sprite différent affiché 
par l'image spécifiée par la propriété Target Graphic. 

— Animation : à chaque état visuel correspond un état d'une animation. Un 
bouton auto generate animation permet de générer une animation possé- 
dant les bons états. Ce type de transition est le plus souple mais le plus fas- 
tidieux à configurer car il faut faire chaque animation. 


Voici un exemple de configuration permettant d'avoir un bouton vert fluo 
lorsque l'utilisateur appuie dessus : 


BRemarque 


Ce comportement de transition entre états visuels est en réalité porté par la 
classe Selectable dans Unity et il est commun à tous les éléments avec le- 
quel l'utilisateur peut interagir (bouton, champ de saisie de texte, etc.). 
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Définir le sens de navigation au clavier 


La zone Navigation dans l'Inspector permet de définir quel sera le prochain 
ou le précédent élément sélectionné lorsque l'utilisateur utilise les flèches 
directionnelles dans l'interface. Ce type de configuration peut paraître inutile 
sur un déploiement mobile mais est primordiale pour un déploiement ciblant 
des consoles où la navigation est faite à l'aide d'une manette. 


À noter que pour être éligible, ce prochain composant sera obligatoirement 
dérivé de la classe Selectable. 


Plusieurs valeurs de configuration sont possibles : 


— Automatic : Unity va déterminer de lui-même quelles sont les cibles de na- 
vigation les mieux adaptées. Il s'agit de la valeur par défaut. 


— Horizontal : seules les touches gauche et droite fonctionnent et permettent 
d'aller sur les premiers éléments à droite et à gauche. 


— Vertical : seules les touches bas et haut permettent la navigation sur les 
premiers éléments en haut et en bas. 


— None : la navigation au clavier est désactivée. 


— Explicit : dans ce mode, vous spécifiez quels sont les prochains éléments 
associés à chaque touche. 


Prenons comme exemple cinq boutons disposés en étoile : haut, gauche, bas, 
centre et droite. Pour configurer la navigation au clavier dans le mode 
Explicit sur le bouton central, il faut suivre ces étapes : 


Sélectionnez le GameObject correspondant au bouton central dans l'onglet 
Hierarchy. 


Changez la propriété Navigation dans l'Inspector et assignez-lui la valeur 
Explicit. 


AConstatez que quatre champs Select On Up/Down/Left/Right apparais- 
sent dans l'Inspector. 


AGlissez-déposez le bouton "Gauche" dans la propriété Select On Left de la 
fenêtre Hierarchy vers l'Inspector. Refaites ces étapes pour assigner les 
boutons de droite, du haut et du bas dans les propriétés correspondantes du 
bouton central. 
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Sélectionnez le bouton de gauche et de droite et assignez-leur une naviga- 
tion de type Horizontal. 


Sélectionnez le bouton du bas et du haut et assignez-leur une navigation de 
type Vertical. 


Afin de faciliter la visualisation des chemins de navigation, l'Inspector propose 
un bouton Visualize dans l'Inspector, en dessous des champs Navigation. En 
cliquant sur celui-ci, les différentes navigations au clavier apparaissent sous la 
forme de flèches jaunes dans la vue Scene. La navigation de l'élément sélec- 
tionné est en gras et les navigations des autres éléments vers celui-ci apparais- 
sent de manière semi-transparente. Dans le cas de l'exemple réalisé, Unity 
présente cet affichage : 


Dons 


Remarque 


Ce comportement de navigation entre éléments est lui aussi porté par la 
classe Selectable dans Unity et il est commun à tous les éléments avec 
lequel l'utilisateur peut interagir (bouton, champ de saisie de texte, etc), 
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Réagir au clic sur un bouton 


Le clic sur un bouton est matérialisé sous la forme d'un événement 
OnClick() du composant Button. 


Il est donc possible d'appeler une méthode prenant zéro ou un paramètre ou 
encore de modifier un champ simple d'un composant lors du clic sur un bouton. 


Voici la procédure permettant d'afficher un message dans la console lors du 
clic sur le bouton central précédemment créé : 


ZCréez un script C# et nommez-le ButtonEventReceiver. 
DGlissez-déposez ce script sur le composant contenant déjà le bouton central. 


Ajoutez une méthode simple AppelleMoi prenant un paramètre de type 
string parami et retournant void. Dans le corps de la méthode, appelez la 
méthode Debug.Log pour afficher le paramètre param1. 

Dans l'Inspector, sur le composant Button, cliquez sur le symbole + pour 


12,2 


ajouter un gestionnaire d'événement. 


DGlissez-déposez le GameObiject où est posé le script ButtonEventRecei - 
ver dans la zone d'assignation. 


Dans la combobox, choisissez ButtonEventReceiver puis Appelle- 
Moi. 


Dans la zone de texte, renseignez le message à afficher dans la console. 
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Voici l'Inspector une fois ces étapes suivies : 


Voici le code définissant le script ButtonEventReceiver : 


public class ButtonEventReceiver : MonoBehaviour 


{ 


public void AppelleMoi (string paraml) 


{ 
} 


Debug.Log (paraml) ; 


Remarque 


Ce type de script peut paraître simple mais il est en réalité très pratique lorsque 
vous souhaitez déboguer votre application. 
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Utilisation d'un composant via un script 


Les différentes propriétés du composant Button visibles dans l'Inspector sont 
toutes disponibles via le code d'un script. La démarche est toujours la même : 
récupérer l'instance du composant Button du GameObject et modifier la pro- 
priété voulue. Voici un exemple modifiant la propriété interactable 
depuis le code : 


var button = GetComponent<Button» () ; 
button.interactable = true; 


Interactions avec les Selectable via un script 


Comme évoqué un peu plus tôt dans ce chapitre, les boutons ainsi que 
d'autres scripts dérivent de la classe Selectable. Cette classe expose notam- 
ment plusieurs éléments pratiques d'utilisation via un script : 


- FindSelectableOnDown/Left/Up/Right : cette méthode retourne le 
prochain Selectable sur l'axe haut, bas, gauche ou droit en utilisant la 
configuration du script. 


- FindSelectable : cette méthode prend en paramètre un vecteur et re- 
tourne le prochain Selectable sur cet axe. 


— Select : cette méthode sélectionne l'instance sur laquelle elle est appelée. 


— allSelectables : cette propriété statique retourne la liste de tous les élé- 
ments de type Selectable actifs dans la scène. 


Par défaut, aucun élément n'est sélectionné dans la scène et il peut par 
exemple être intéressant d'en sélectionner un afin de le définir comme point 
de départ de la navigation pour l'utilisateur. Pour cela, il suffit de poser ce 
script sur n'importe quel élément ayant un composant Selectable : 


void Start () 

{ 
var selectable = GetComponent<Selectable> (); 
selectable.Select (); 


317 


316 Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


4.5 InputField : afficher une zone de saisie de texte 


Ce composant permet à l'utilisateur de saisir du texte. Cela est notamment 
pratique lors de la création de formulaire. 


Par défaut, lors de l'ajout dans la scène, Unity crée un GameObject parent 
nommé InputField contenant un composant InputField et un composant 
Image correspondant au rendu visuel du champ. Il possède aussi trois 
GameObjects enfants : 


— InputField Input Caret : correspond au curseur clignotant indiquant à 
l'utilisateur où il se trouve dans la zone de texte. 
— Text : affiche tout ou partie du texte saisi même en cours d'édition. 


— Placeholder : affiche un texte de remplacement lorsque le champ texte est 
vide. Cet élément est optionnel et peut être supprimé. Le texte par défaut 
est à saisir directement sur ce composant. 


ède 
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Configuration du composant 


Les propriétés issues de la classe Selectable (Navigation, Interac- 
table et Transition) sont présentes et se comportent de la même façon 
que pour le composant Button. 


Cependant, des paramètres spécifiques sont disponibles : 


— Text Component : correspond à l'élément contenant un composant Text 
permettant l'affichage du texte. 


- Text : correspond au texte affiché et/ou saisi par l'utilisateur dans la zone 
de texte 


— Character Limit : nombre maximum de caractères pour la zone. 


- Content Type : type de contenu autorisé. Ce champ limite les caractères 
autorisés par la zone de texte. Attention, la validation est faite lors de la sai- 
sie et changer cette valeur dynamiquement ne valide pas le texte déjà entré. 
Les valeurs possibles sont classiques et parlent d'elles-mêmes : Integer 
Number, Integer Decimal, Name, Email, Password, etc. 


- Line Type : est-ce que la zone n'autorise qu'une seule ligne (Single Line), 
plusieurs lignes avec changement lors de l'appui sur entrée (MultiLine 
NewLine) ou plusieurs lignes avec des sauts gérés automatiquement par 
Unity lorsque le contenu devient trop grand (MultiLine Submit) ? 


— Placeholder : correspond à l'élément contenant un composant Text per- 
mettant l'affichage du texte incitant à saisir du texte. 


— Caret Blink Rate : fréquence de clignotement du curseur (nombre de fois 
par seconde). 


— Selection Color : couleur de surbrillance du texte sélectionné par l'utilisa- 
teur. 


— Hide Mobile Input : certains OS affichent un champ de saisie en dehors 
de l'interface (Android notamment). En cochant cette case, celui-ci sera ca- 
ché et l'affichage sera entièrement géré par Unity. 
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4.5.2 Événements exposés 
Le composant InputField expose deux événements de type UnityEvent : 


— OnValueChange : cet événement est levé à chaque modification de valeur 
de la zone de saisie. Le paramètre du gestionnaire d'événement 
correspondra au champ saisi dans la zone. 


- EndEdit : cet événement est levé lorsque le composant perd le focus : clic 
de l'utilisateur sur une autre zone, appui sur la touche [Entrée] pour valider 
la saisie, un autre composant est sélectionné par du code, etc. Le paramètre 
du gestionnaire d'événement correspondra au champ saisi dans la zone. 


. Voici un exemple de configuration dans l'Inspector permettant de réagir à ces 
événements. 


HRemarque 


Attention à bien choisir un binding dynamique lors de la sélection de la 
méthode appelée lors du clic. 


Voici le code associé à ces abonnements : 


public void TextValueChanged (string newValue) 


{ 
} 


public void TextEndEdit (string newValue) 


{ 


Debug.Log("[InputField::TextValueChanged] " + newValue) ; 
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Ê Debug.Log("[InputField::TextEndEdit] " + newValue) ; 
} 


4.5.3 Utilisation via un script 


L'utilisation de ce composant via un script est classique : récupération du com- 
posant et utilisation des propriétés et/ou des méthodes disponibles. 


Voici quelques méthodes et configurations utiles lors de son utilisation : 


— text : valeur saisie par l'utilisateur. 


- ActivatelnputField: permet d'activer le composant. Le texte sera entiè- 
rement sélectionné. Équivalent de l'appel successif à SetActive (true) et 
Select (). 


- MoveTextEnd/Start : fonction d'aide permettant de déplacer le curseur 
à la fin ou au début du champ. 


- asteriskChar : permet de spécifier la valeur du caractère de remplace- 
ment lorsque le type de contenu est Password. "*"' est bien sûr la valeur 
par défaut. 


- Validate : valide le texte saisi par rapport au type de contenu choisi. 


- Append : ajoute un caractère à la fin du champ de texte. 


Remarque 


Attention à bien lire la valeur du texte sur le composant InputField et non 
pas sur l'élément Text du GameObject enfant. Ce dernier est découpé 
(clamp) automatiquement pour n'afficher qu'une partie du texte par rapport 
à la taille du composant, la position du curseur et la taille du texte, 


Il est aussi possible de manipuler la sélection du texte : 


- caretPosition : index commençant à zéro représentant la position du 
curseur ou la position de la fin de la sélection si du texte est sélectionné. 
- selectionAnchorPosition : index du début de la sélection. 


— selectionFocusPosition : index de fin de la sélection. Similaire à 
caretPositon. 
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Certaines méthodes, telle ActivatelnputField, ont comme comporte- 
ment de sélectionner le texte présent dans le champ. Un des effets de bord de 
leur appel est qu'il est impossible de modifier la sélection durant la même 
frame. Cela ne serait tout simplement pas pris en compte par Unity. La solu- 
tion consiste à laisser passer une frame (via une coroutine par exemple) avant 
de changer la sélection. Voici un exemple de code sélectionnant un composant 
InputField et le texte compris entre le troisième et le septième caractère. 


private InputField input; 


void Start () 

{ 
// récupération du composant 
_input = GetComponent<InputField>(); 
_input .ActivatelnputField(); 


// Assignation d'un texte arbitraire 
_input.text = "bonjour je suis du texte pré-saisi"; 


// Changement de la sélection 
StartCoroutine (ChangeSelection() ); 


} 


private IEnumerator ChangeSelection () 


{ 


// Laissons passer une frame 
yield return new WaitForEndOfFrame () ; 


_input.selectionAnchorPosition = 3; 
_input.selectionFocusPosition = 7; 


Remarque 


Attention, lorsque vous souhaitez utiliser caret Position pour changer la fin 
de la sélection du texte, il est obligatoire de faire l'assignation de ce dernier 
avant de faire celle de selectionFocusPosition. 
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4.6 Toggjle et ToggleGroup : permettre un choix dans une liste 


Le composant Toggle correspond à une case à cocher. Il est possible d'asso- 
cier plusieurs Toggle ensemble pour les transformer en "bouton radio" à l'aide 
d'un ToggleGroup. Dans ce cas, seule une case à cocher d'un même groupe 
peut être cochée à un instant t. 


Lorsqu'un élément Toggle est ajouté dans la scène, Unity crée un GameOb- 
ject parent contenant le composant Toggle avec les sous-éléments suivants : 
— Background : correspond à l'image de fond (blanche par défaut). 

— Checkmark : correspond à l'image de la coche. 

— Label : correspond au texte affiché à côté de la case. 
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Configuration du composant 


Le composant Toggle est configurable dans l'Inspector à l'aide des propriétés 
suivantes : 
— Is On : indique si la case est cochée ou non. 


- Toggle Transition : type de transition graphique lors du changement 
d'état. Actuellement, seule une animation de type fondu est disponible mais 
il est possible de la désactiver entièrement. 


— Graphic : composant image représentant la coche. 
— Group : le composant ToggleGroup associé à cette case à cocher. 


Assignation d'un ToggleGroup 


L'ajout d'un composant ToggleGroup se fait manuellement dans l'éditeur. 
Par habitude, il est placé sur un GameObject parent contenant les toggles afin 
de le retrouver plus facilement. 


Sélectionnez le GameObiject parent dans l'onglet Hierarchy. 


Cliquez le bouton Add Component et saisissez toggle group dans la zone 
de recherche. Double cliquez sur Toggle Group dans les résultats. 
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Il est alors nécessaire d'assigner ce groupe à chacun des toggles enfants : 
Sélectionnez le GameObject portant le composant Toggle. 
AGlissez-déposez le GameObject parent dans la zone ToggleGroup. 


Le composant ToggleGroup possède une seule propriété Allow Switch 
Off. Celle-ci indique s'il est possible de décocher toutes les cases à cocher ou si 
une case est toujours cochée au minimum. 


BRemarque 


Attention, l'assignation d'un ToggleGroup n'applique pas les règles au 
lancement et il est nécessaire de s'assurer manuellement que les valeurs 
initiales (cochées/décochées) sont valides. 


4.6.3 Événement du composant 


Le composant Toggle expose un seul événement OnValueChanged corres- 
pondant au changement de valeur de la propriété Is On. 


D 


On Value Changed (Boolean) 


Remarque 


Attention à bien choisir un binding dynamique lors de la sélection de la 
méthode appelée lors du changement de valeur. 


Le gestionnaire d'événement à définir est une méthode prenant en paramètre 
la nouvelle valeur. En voici un exemple affichant celle-ci dans la console : 


public void OnToggleValueChanged (bool newValue) 


{ 
} 


Debug.Log("OnToggleValueChanged : " + newValue) ; 
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4.6.4 Utilisation via un script 


Le composant Toggle ne propose pas de modifier d'autres propriétés que sa 
configuration. La plus importante, Is On, retourne un booléen. 


ES 


Le composant ToggleGroup propose quant à lui des méthodes 
intéressantes : 


— Un/Register Toggle : permet d'ajouter un toggle à ce groupe. 


- Set AI Toggles Off : permet de décocher tous les toggles du groupe. Cela 
fonctionne même si la propriété Allow Switch Off n'est pas activée. 


- Any Toggles On : retourne un booléen indiquant si un des toggles du 
groupe est coché. 


- Active Toggles : retourne les composants Toggle actifs de ce groupe. 


Voici un exemple de code parcourant toutes les toggles d'un groupe pour 
afficher le nom du GameObject des toggles cochés dans la console. 


void Start () 


{ 


var toggleGroup = GetComponent<ToggleGroup> () ; 


// Parcours des toggles actifs du groupe 
foreach (var activeToggle in toggleGroup.ActiveToggles ()) 
{ 

// si le toggle est coché 

if (activeToggle.isOn) 


// Affichage du nom du GameObject du toggle 
Debug.Log(activeToggle.gameObject .name) ; 
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Slider : choisir une valeur numérique 


Le composant Slider permet de proposer à l'utilisateur un choix de valeur 
numérique dans une zone de valeurs bornée par un minimum et un maxi- 
mum. 


Par défaut, lorsque vous ajoutez un slider dans la scène, il est composé d'un 
élément nommé Slider portant le script principal Slider. Ce GameObiject 
parent possède plusieurs enfants : 


- Background : correspond à la zone de fond. Par défaut, c'est un sprite 
représentant une ligne blanche. 


- Fill Area: correspond à la zone remplie/choisie par l'utilisateur. Par dé- 
faut, c'est un sprite représentant une ligne blanche. Elle est configurée dans 
l'illustration suivante en rouge. 


- Handle Slide Area: correspond à la poignée de sélection de valeur. Elle 
contient par défaut un sprite représentant un cercle. 


‘E Hierarchy : . . - © Inspector 
LA 


GE 
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Configuration du composant 


Le composant Slider dérive de la classe Selectable et les options de 
configuration de la navigation et de transition sont les mêmes que pour le 
bouton. 


Ces propriétés sont spécifiques au slider : 


- Fill/Handle Rect : indique au composant Slider les deux GameObjects 
servant de poignée et de remplissage. 


— Direction : indique le sens de sélection des valeurs. De gauche à droite (Left 
To Right), de droite à gauche (Right To Left), de bas en haut (Bottom to 
Top) ou encore de haut en bas (Top to Bottom). Pour ces deux dernières 
valeurs, le slider est affiché verticalement au lieu d'horizontalement. 


— Min et Max Value : permettent de définir la zone de choix de valeurs 
possibles. Les bornes peuvent aussi être négatives si nécessaire. 


— Whole Numbers : indique si les valeurs pouvant être choisies sont obliga- 
toirement des nombres entiers. Dans ce cas, la poignée se déplacera par à- 
coups, de nombre entier en nombre entier. 


— Value : indique la valeur choisie. Permet aussi de définir la valeur par défaut 
au moment du design. 


Remarque 


Nous pouvons déplorer l'impossibilité de définir un pas de changement de 
valeur lorsque la configuration Whole Numbers est choisie et il faudra utiliser un 
composant ScrollBar pour avoir ce comportement. 


Événement exposé 


Le composant Slider n'expose qu'un événement OnValueChanged au 
comportement sans équivoque : il est levé lorsque la valeur change et le para- 
mètre du gestionnaire d'événement sera la valeur choisie. 


Voici un exemple changeant l'opacité d'un composant Image en fonction de 
la valeur du slider. Vous remarquerez que l'utilisation de normalizedvalue 
permet de ne pas avoir à se soucier des valeurs des bornes minimum et maxi- 
mum. 
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public void OnSliderValueChanged(float chosenValue) 
{ 

// couleur originale 

var c = TargetIlmage.color; 


// Gardons les composantes RGB 
TargetImage.color = new Color(c.r, c.g, c.b, 


// mettons à jour le canal alpha 

// en fonction de la valeur du slider 
slider.normalizedValue 

ds 


Remarque 


Attention, cet événement est levé très fréquemment lors de l'utilisation du slider 
et il est important de ne pas faire quelque chose de très consommateur si l'on 
ne veut pas avoir des problèmes de performance ou des ralentissements. 
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4.7.3 Utilisation via un script 


L'utilisation via un script permet de modifier la configuration directement 
depuis le code et de lire la valeur couramment assignée. Voici quelques possi- 
bilités supplémentaires : 


- normalizedValue : permet de retrouver la valeur courante en tant que 
pourcentage par rapport aux bornes minimum et maximum. 


— SetDirection : permet de changer la direction du slider. Un second para- 
mètre indique si le rendu graphique doit aussi être mis à jour par cette mé- 
thode, notamment lorsque l'on passe d'horizontal à vertical. 


- Voici un exemple de code mettant en œuvre cela : 


4.8 


var slider = GetComponent<Slider»> (); 
Debug.Log("[Slider] valeur actuelle : " + slider.value); 


slider.minValue -100; 
slider.maxValue = 100; 
slider.value = 30; 


// affiche 0,65 = 130 / (-1*100 + 100) 
Debug.Log("[Slider] valeur normalisée : " + slider.normalizedValue) ; 


slider .SetDirection(Slider.Direction.TopToBottom, true); 


Scrollbar : afficher une barre de défilement 


Le composant Scrollbar, très classique, permet à l'utilisateur de spécifier 
un emplacement précis en pourcentage dans une zone de valeur. 


Il est composé par défaut d'un GameObiject portant le script Scrollbar et 
un script Image représentant l'image de fond (la barre blanche). Il possède un 
GameObject nommé Handle correspondant à la poignée dans un autre (vide) 
Sliding Area. 


© Editions ENI - AII rights reserved 


331 


Unity Ul et interfaces utilisateurs 
Chapitre 9 


{ Lo Inspector - 


: Listis Empty 


4.8.1 Configuration du script 


La configuration se fait dans l'Inspector qui expose, en plus des propriétés 
classiques d'un Selectable, quelques-unes spécifiques au composant 
Scrollbar : 

— Handler Rect : RectTransform de la poignée. 

— Direction : la direction d'affichage de la barre de défilement. 

— Value : la valeur actuelle (pourcentage normalisé entre 0 et 1). 


— Size : taille relative de la poignée (en pourcentage normalisé entre 0 et 1). 
Vous le verrez plus tard, cette propriété est utilisée pour permettre à l'utili- 
sateur de se représenter la longueur du défilement possible. 


— Number Of Steps : nombre de crans lors de l'utilisation de la barre de défi- 
lement. Renseigner 0 pour désactiver cette fonctionnalité. 
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4.8.2 Événement exposé 


Le composant Scrollbar expose un seul événement OnValueChanged 
similaire à celui du slider et il est donc inutile de le présenter plus en détail. 


4.8.3 Utilisation via un script 


La configuration du composant est exposée sous la forme de propriétés. Une 
méthode SetDirection, elle aussi similaire à celle du slider, est disponible 
pour modifier la direction de la barre de défilement dynamiquement. 


Voici un exemple d'affichage de la valeur courante : 


var scrollbar = GetComponent<Scrollbar> (); 
Debug.Log("[Scrollbar] valeur : " + scrollbar.value); 


4.9 ScrollRect et Mask : afficher une zone de défilement 


Le composant ScrollRect permet l'affichage d'un très grand contenu sur une 
ss P &* ê 
petite zone dans laquelle l'utilisateur peut naviguer avec ou sans barres de défi- 
lement. Cela est par exemple très pratique pour réaliser l'affichage en bonne 
| és P a ê 
qualité d'une image sur l'écran de taille restreinte d'un téléphone portable. 


Le composant Mask permet de limiter l'affichage du contenu uniquement à la 
zone choisie pour son affichage dans la scène au lieu de le laisser déborder. 


4.9.1 Ajout d'un ScrollRect et de son contenu dans la scène 


Unity ne propose pas l'ajout d'une zone de défilement via ses menus et il faut 
donc le faire manuellement. Voici la procédure permettant de mettre en place 
les différents éléments nécessaires. 


Dans l'onglet Hierarchy, si ce n'est pas déjà le cas, ajoutez un GameObject 
portant un Canvas en sélectionnant ce menu : Create - UI - Canvas. 


2 Toujours dans l'onglet Hierarchy, ajoutez un GameObiject enfant à celui- 
ci : sélectionnez le Canvas puis cliquez sur Create - Create empty child. 
Renommez ce dernier ScrollRect dans l'Inspector. 


Sur ce GameObiject, cliquez sur Add Component dans l'Inspector. 
Recherchez ScrollRect et ajoutez le composant. 
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La scène contient maintenant une zone scrollable vide de taille 100x100 : 


Voici la procédure permettant d'ajouter une image comme contenu de cette 
zone : 


Dans l'onglet Hierarchy, cliquez sur Create - UI - Image. 


DRenommez le GameObject créé ScrollContent et glissez-déposez-le dans 
l'élément ScrollRect précédemment créé. c 


Sélectionnez une image pour le script Image et cliquez sur le bouton Set 
Native Size dans l'Inspector afin de donner au composant les dimensions 
de celle-ci. 


Sélectionnez l'élément ScrollRect et glissez-déposez l'élément ScrollCon- 
tent dans la propriété Content du composant ScrollRect. 
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Remarque 


Dans notre exemple, le contenu est une simple image, mais s'il devait être plus 
complexe il faut toujours veiller à le placer dans un seul GameObject parent. 


En lançant la lecture de la scène dans Unity avec une petite résolution pour la 
vue Game, on constate que l'image n'est pas affichée entièrement mais qu'il est 
possible de se déplacer en son sein en faisant des glisser-déposer avec la souris. 


4.9.2 Ajout d'un Mask pour contraindre l'affichage 


Vous pouvez aussi remarquer que les bords de l'image ne peuvent pas sortir de 
l'élément ScrollRect mais que son affichage peut le faire. Par exemple, si 
vous tirez l'image sur la droite, elle ne voudra plus bouger une fois le bord 
gauche du ScrollRect atteint par le bord gauche de l'image. Cependant, 
l'image dépasse des bords du Scrol1Rect sur le bas et sur la droite. 
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Pour limiter l'affichage de l'image au ScrollRect lui-même, ajoutez un 
composant Mask en suivant cette procédure : 


Sélectionnez l'élément ScrollRect, cliquez sur Add Component. Recher- 
chez et ajoutez le script Mask. 


Toujours sur l'élément ScrollRect, cliquez sur Add Component. Recher- 
chez et ajoutez un composant Image. Il n'est pas nécessaire d'associer un 
sprite pour le moment. 


L'affichage est alors contraint à la zone du ScrollRect : en se déplaçant 
dans l'image, seule une portion de celle-ci est visible. 
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Le script Image sert ici de calque de découpe au composant Mask. En sélec- 
tionnant un Sprite avec des zones de transparence, l'intérieur du contenu sera 
découpé selon la forme du Sprite. Voici un exemple utilisant une image d'un 
cœur avec une zone transparente en forme d'étoile en son sein : 


Ajout de barres de défilement 


Il est alors intéressant de rajouter des barres de défilement horizontales et 
verticales en suivant cette procédure : 


Effectuez un clic droit sur l'élément ScrollRect et choisissez UI - Scroll- 
Bar. Nommez le composant créé HorizontalScrollBar. 


Changez à 0 la valeur (champ Value de l'Inspector) du composant 
Scrollbar créé. 


Sélectionnez HorizontalScrollBar et dans l'Inspector, choisissez bottom/ 
stretch comme valeur d'ancre prédéfinie. Changez la hauteur de la scrollbar 
pour 10, placez la valeur 10 dans le champ Right et 5 en Y. Cela place la 
barre en bas du ScrollRect pour prendre toute sa largeur sauf à droite où 
10 pixels sont laissés pour la barre de défilement vertical. 
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Effectuez un clic droit sur l'élément ScrollRect et choisissez UI - Scroll- 
Bar. Nommez le composant créé VerticalScrollBar. 


Modifiez la direction du composant Scrollbar pour la valeur Bottom To 
Top et mettez sa valeur à 1. 


Sélectionnez VerticalScrollBar et dans l'Inspector, choisissez stretch/ 
right comme valeur d'ancre prédéfinie. Changez la largeur de la Scro1l1- 
bar pour 10, placez la valeur 10 dans le champ Bottom et -5 en X. Cela 
place la barre en bas du ScrollRect pour prendre toute sa hauteur sauf à 
droite où 10 pixels sont laissés pour la barre de défilement vertical. 
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Sélectionnez l'élément ScrollRect et glissez-déposez VerticalScrollBar 
dans le champ Vertical ScrollBar. 


AGlissez-déposez HorizontalScrollBar dans le champ Horizontal Scroll- 
Bar. 


Dans cet exemple, les barres de défilement sont placées dans le ScroliRect 
mais il est tout à fait possible de les placer ailleurs dans le Canvas. 


HRemarque 


Attention, le composant Mask impacte aussi les barres de défilement qui sont 
donc aussi potentiellement cachées. 


Configuration du ScrollRect 


Le composant ScrollRect expose plusieurs paramètres au travers de 
l'Inspector : 


— Content : spécifie le contenu à faire défiler. 


- Horizontal/Vertical : indique si le défilement est autorisé horizontale- 
ment et/ou verticalement. Par défaut, les deux cases sont cochées. 


—- Movement Type : spécifie le comportement du défilement. Elastic per- 
met d'apporter un côté élastique au mouvement, il sera possible de faire sor- 
tir un peu le contenu et il reviendra en place avec un petit rebond dont 
l'intensité est configurable via la propriété Elasticity. La valeur Clamped 
force le contenu à rester à l'intérieur du ScrollRect. Finalement, la valeur 
Unrestricted laisse le contenu sortir du ScrollRect sans restriction. 
Dans cette configuration, il est possible de se retrouver avec un contenu 
inaccessible pour l'utilisateur s'il le laisse sortir du ScrollRect complète- 
ment. 


— Inertia : active ou non une inertie pour proposer un défilement plus naturel 


à l'utilisateur. L'intensité de l'inertie est configurable avec la propriété 
Deceleration Rate. Plus elle sera élevée, plus le défilement stoppera vite. 


— Scroll Sensitivity : bien que visible dans l'éditeur cette propriété n'est pas 


documentée dans le manuel d'Unity et modifier sa valeur ne semble pas 
avoir d'impact sur le comportement du ScrollRect. 
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- Horizontal/Vertical Scrollbar : spécifie les barres de défilement option- 
nelles. 


4.9.5 Événement exposé 


Le composant ScrollRect expose un seul événement OnValueChanged 
déclenché à chaque déplacement du contenu. Cet événement fournit en para- 
mètre un vecteur de deux dimensions indiquant la nouvelle position normali- 
sée du contenu dans le ScrollRect. La valeur (0,0) représentant le bord bas 
gauche et (1,1) le bord haut droit. Une façon simple d'appréhender ces valeurs 
et de se rendre compte qu'il s'agit au final des valeurs des barres de défilement 
horizontal et vertical. 


Voici un exemple de gestionnaire d'événement : 


public void OnScrollRectValueChanged (Vector2 newValue) 


{ 
} 


Debug.Log("[ScrollRect] nouvelle valeur : " + newValue) ; 


BHRemarque 
Attention aux performances : cet événement est levé très fréquemment ! 
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4.9.6 Utilisation via un script 


Toutes les propriétés de configuration du ScrollRect sont disponibles au 
travers du code. Ce composant en expose cependant d'autres : 


- vertical/horizontalNormalizedPosition : les positions verti- 
cales et horizontales normalisées. 


- normalizedPosition:la position normalisée sous la forme d'un vecteur 
25. 


- StopMovement : stoppe immédiatement tout mouvement du contenu 
dans le ScrollRect. 


Voici un exemple d'utilisation de ces méthodes et propriétés : 


void Start () 
{ 
var scrollRect = GetComponent<ScrollRect>(); 
Debug.Log("[ScrollRect] position : " 
+ scrollRect.normalizedPosition) ; 


StartCoroutine (StopEachseconds () ); 


} 


private IEnumerator StopEachseconds () 

{ 
yield return new WaitForSeconds (1); 
var scrollRect = GetComponent<ScrollRect> (); 
scrollRect.StopMovement () ; 
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. Les différents moyens de disposer les éléments 


Unity propose aussi des moyens pour disposer ces différents éléments les uns 
à côté des autres ainsi que pour contrôler la manière dont se comportent leurs 
dimensions. 


Layout Element 


Le système de disposition des éléments d'interface graphique se repose, dans 
ses mécanismes intrinsèques, sur un composant nommé LayoutElement. 
Tous les éléments d'UI disposent de celui-ci même s'il n'est pas visible dans 
l'Inspector. Afin de permettre une configuration plus personnalisée, il est 
possible de surcharger cette valeur par défaut par une valeur configurée dans 
l'Inspector. 


Voici la procédure permettant d'ajouter une image dans la scène et de surcharger 
ses paramètres : 


Réalisez un clic droit sur le Canvas parent et sélectionnez UI - Image. 


Sélectionnez l'élément nouvellement créé et nommez-le LayoutEle- 
mentTester. 


Cliquez sur le bouton Add Component. Recherchez puis ajoutez le script 
LayoutElement. 


Remarquez que dans la vue de détails de l'Inspector, il est possible de voir les 
propriétés de disposition par défaut en sélectionnant Layout Properties. 
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Configuration du LayoutElement 


Dans l'Inspector, le composant LayoutElement apparaît comme une liste 
de case à cocher décochée. En en cochant une, il devient possible de personna- 
liser sa valeur. Certaines valeurs peuvent être grisées si elles sont désactivées 
par un autre composant du layout sur lesquelles nous reviendrons plus tard. 


Voici les propriétés exposées dans l'Inspector : 


— Min Width/Height : correspond à la taille minimum du composant et de 
ses enfants. Il ne lui sera pas assigné une taille plus petite même s'il ne rentre 
pas dans son parent. 


— Preferred Width/Height : correspond à la taille optimale souhaitée pour 
ce composant. 


— Flexible Width/Height : ce paramètre indique au composant Layout 
parent la proportion pondérée de ce composant à prendre une éventuelle 
place disponible par rapport aux composants de même niveau que lui. La 
somme des valeurs du paramètre de tous les composants frères de ce com- 
posant est faite et à chaque composant est attribuée la valeur demandée. En 
renseignant 0, on indique que le composant ne veut pas faire partie de cette 
redistribution. 
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5.1.2 
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HRemarque 


Un exemple concret d'utilisation de Flexible Width/Height sera abordé plus 
tard dans ce chapitre. 


Comportement du système de dimensionnement 


L'allocation des tailles aux éléments est faite en trois passes séquentielles uti- 
lisant notamment les valeurs des LayoutElements. 


— Phase 1 : tous les éléments sont parcourus et leurs tailles minimum et 
maximum sont assignées. 


— Phase 2 : tous les éléments sont parcourus et, si de la place est disponible, 
leurs tailles préférées sont assignées. 


— Phase 3: tous les éléments sont parcourus et la taille restante disponible est 
assignée aux composants n'ayant pas une taille flexible à O. 


HRemarque 


La faille disponible dont il est question va dépendre du composant de layout 
parent utilisé pour placer le composant. 


Horizontal Layout Group (HGL) 


Ce composant à ajouter manuellement sur un GameObject permet de placer 
ses éléments enfants les uns à côté des autres sur un axe horizontal. Utilisé 
conjointement avec un ScrollRect, cela est très pratique pour créer une 
liste d'éléments activables par l'utilisateur. 


Voici la procédure pour ajouter un Horizontal Layout Group: 


DEffectuez un clic droit sur l'élément Canvas parent et choisissez Create 
Empty. 


ZNommez cet élément Horizontal Layout (facultatif). 


Dans la fenêtre de l'Inspector, cliquez sur Add Component. Recherchez et 
ajoutez un composant Horizontal Layout Group. 
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Ajoutez deux éléments enfants Image et choisissez un Sprite à afficher. 


Layout Properties 


5.2.1 Configuration du composant 
La configuration de ce script est au final très simple : 


— Padding : permet de configurer l'espace à introduire entre le contenu (les 
éléments disposés horizontalement) et le bord du RectTransform de 
l'HGL. Cela permet d'éviter que le contenu soit collé au bord de son parent. 


- Spacing : permet de configurer l'espace à introduire entre chacun des 
éléments contrôlés par l'HGL. 


- Child Alignment : lorsque l'HGL est plus grand que la taille nécessaire per- 
mettant d'afficher les enfants, cette option indique comment aligner ceux-ci. 
Les valeurs correspondent aux couples (alignement vertical, alignement hori- 
zontal) suivants : haut-gauche, haut-milieu, haut-droit, milieu-droit, bas- 
droit, bas-milieu, bas-gauche et milieu-gauche. 


— Child Force Expand : indique au HGL s'il doit forcer son enfant à s'agran- 
dir sur toute la taille à sa disposition, verticalement ou horizontalement en 
prenant aussi en compte la configuration de taille flexible. Si cette option 
n'est pas cochée, les éléments utiliseront leur Preferred Width comme 
taille maximale. 
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Voici un exemple de configuration mettant cela en œuvre : 


5.2.2 Comportement des mesures du composant 


Lorsque ce layout est présent, la taille du RectTrans£orm est calculée à par- 
tir des éléments enfants : 


— Sa taille minimum est la somme des tailles minimum de ses enfants en 
intégrant les espaces configurés (Spacing et Padding). 


— Sa taille préférée est la somme des tailles préférées de ses enfants en inté- 
grant les espaces configurés (Spacing et Padding). 


5.2.3 Exemple de configuration utilisant les tailles flexibles 


Afin d'illustrer le comportement des tailles flexibles au sein des layouts, nous 
allons créer cette situation : 


— Affichage de cinq images au sein d'un HGL dimensionné pour pouvoir en 
afficher six. 


— Les trois premières s'afficheront dans leur taille native. 


— La quatrième image s'affichera en prenant sa taille native plus 25 % de la 
taille restant dans l'HGL. 
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— La cinquième image s'affichera en prenant sa taille native plus 75 % de la 
taille restant dans l'HGL. 


En partant de l'exemple précédemment réalisé, suivez cette procédure : 


Sélectionnez le GameObject portant l'HGL, choisissez un pivot central et 
configurez un espacement de cinq pixels afin de séparer les éléments. 


DConfigurez une largeur correspondant à six éléments en prenant l'espace- 
ment en compte. Cela sera dans notre cas : 5*(800 + 5) + 800 = 4830. 


DAjoutez trois autres éléments images comme enfants de l'HGL. 


Sélectionnez les deux derniers éléments images, cliquez sur Add Compo- 
nent dans l'Inspector puis ajoutez un composant Layout Element. 


ŒSur le GameObject de la quatrième image, cochez la case Flexible Width 
du Layout Element et configurez sa valeur à 0,25. À ce stade, ce compo- 
sant prendra toute la taille supplémentaire disponible dans l'HGL car il est 
le seul à participer au mécanisme de taille flexible. 


DSur le GameObject de la cinquième image, cochez la case Flexible Width 
du Layout Element et configurez sa valeur à 0,75. À ce stade, deux com- 
posants participent maintenant au mécanisme de taille flexible. Les tailles 
flexibles correspondent à une valeur totale de 1 (0,25 + 0,75). La quatrième 
image obtient alors 25 % de la taille restante et la cinquième 75 %. 
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5.3 Vertical Layout Group (VGL) 


Le Vertical Group Layout est le pendant vertical de l'HGL et sa confi- 
guration est similaire mais sur un axe vertical. 


5.4 Grid Layout Group (GLG) 


Ce composant permet de disposer ses enfants en prenant comme modèle une 
grille. Celle-ci est définie sous la forme de cellules d'une taille donnée position- 
nées dans un ordre précis. 


@ Inspector 
ä 
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Voici la procédure pour ajouter un Grid Layout Group : 

DEffectuez un clic droit sur l'élément Canvas parent et choisissez Create 
Empty. 

DNommez cet élément Grid Layout (facultatif). 


Dans la fenêtre de l'Inspector, cliquez sur Add Component. Recherchez et 
ajoutez un composant Grid Layout Group. 


DAjoutez trois éléments enfants Image et choisissez un Sprite à afficher 
(facultatif). 


Les trois images ajoutées vont alors s'afficher, chacune dans une cellule, en 
fonction de la configuration du GLG. 


Configuration du composant 
La configuration d'une grille se fait au travers de l'Inspector avec ces propriétés : 


— Cell Size : taille des cellules (hauteur et largeur). 


— Spacing : espace entre chaque cellule. Attention, les bords extérieurs de la 
grille ne sont pas pris en compte. 


— Start Corner : emplacement de la première cellule. 


— Start Axis : axe de disposition des éléments. Ils sont placés soit par ligne 
(Horizontal) soit par colonne (Vertical). 


- Child Alignment : alignement des enfants s'ils ne remplissent pas toute la 
place disponible. 


— Constraint : contrainte supplémentaire de disposition des éléments. Il est 
possible de spécifier un nombre de colonne ou de lignes maximum. Une fois 
cette valeur atteinte, la ligne ou la colonne suivante sera commencée. 
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Voici par exemple une configuration permettant d'empiler verticalement des 
éléments en en plaçant deux par ligne. Pour cela, le nombre de colonnes est 
limité à deux et l'axe utilisé est Horizontal : 


o Inspector 


5.4.2 Comportement des mesures du composant 


La grille ignore complètement la taille (minimum, flexible et préférée) de ses 
enfants et ne se base que sur la taille configurée pour ses cellules et les valeurs 
du Spacing. 


— Si le nombre de colonnes est contraint, la hauteur préférée et minimum du 
LayoutElement sera celle nécessaire pour afficher tous les éléments. 
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— Si le nombre de lignes est contraint, la largeur préférée et minimum du 
LayoutElement sera celle nécessaire pour afficher tous les éléments. 


— Si aucune contrainte n'est mise, les tailles et hauteur préférées correspon- 
dront aux valeurs permettant d'avoir le même nombre de colonnes et de 
lignes. 


Content Size Fitter 


Ce composant un peu particulier permet d'ajuster la taille (les valeurs du 
RectTransf£orm donc) du GameObiject sur lequel il est posé par rapport aux 
valeurs de layout. Lorsqu'Unity dispose et dimensionne les éléments, il met 
lui-même à jour les valeurs du LayoutElement de chaque GameObject et le 
Content Size Fitter permet alors d'assigner les valeurs de celui-ci au 
RectTransform. 


Si par exemple vous souhaitez placer une grille au sein d'une zone de défile- 
ment, ce composant devient inestimable car il assure que les dimensions du 
GameObject seront égales à la place occupée par le contenu. Le contenu à faire 
défiler correspondra donc bien à la grille et son contenu dans son entier. 


Voici la procédure pour ajouter un Content Size Fitter: 


Effectuez un clic droit sur l'élément Canvas parent et choisissez Create 
Empty. 


DNommez cet élément Content Size Fitter (facultatif). 


Dans la fenêtre de l'Inspector, cliquez sur Add Component. Recherchez et 
ajoutez un composant Content Size Fitter. 
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HRemarque 


Le redimensionnement se fera toujours en respectant les valeurs de pivot 
configurées. Par défaut, le composant s'étendra donc autour de lui depuis 
son centre, 


Configuration du composant 


La configuration du composant se fait au sein de l'Inspector via les champs 
Horizontal et Vertical Fit. Ils peuvent prendre une de ces valeurs : 


— Minimum : utilise la taille minimum du LayoutElement implicite ou 
explicite. 

— Preferred Size : utilise la taille minimum du LayoutElement implicite 
ou explicite. 


— Unconstrained : désactive le Content Size Fitter sur l'axe en 
question. 


Si par exemple, vous souhaitez apposer sur une grille (composant GLG) un 
Content Size Fitter permettant de la dimensionner à la taille nécessaire 
à afficher les éléments sur deux colonnes, en le faisant s'étendre depuis le haut, 
il faut suivre cette procédure : 


DAjoutez un composant Content Size Fitter sur le GameObject conte- 
nant la grille. 


Choisissez Preferred Size sur l'axe vertical et horizontal. 


Modifiez la valeur du Pivot dans le RectTrans£form pour mettre un sur 
l'axe Y. La grille sera donc agrandie vers le bas de l'écran en étant alignée en 
haut. 
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HRemarque 


Il ne resterait alors plus qu'à placer cette grille comme contenu d'un 
ScrollRect pour permettre le défilement du contenu. 


6. Localisation d’une application 


La création d'une application diffusée dans plusieurs pays est un problème très 
courant et il est souvent demandé de traduire les textes dans les différentes 
langues. Cela correspond plus précisément à ces besoins : 


— permettre de stocker les traductions dans un fichier par langue facile à 
éditer, 

— définir une langue par défaut si la traduction n'existe pas dans la langue de 
l'utilisateur. 
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Pour réaliser cette fonctionnalité, il est donc nécessaire d'assigner le texte d'un 
composant Text en fonction de la langue du système. 


Logique du composant de traduction 


La logique que nous allons implémenter est assez simple au demeurant : nous 
allons créer un script paramétré par une clé de traduction et ce script sera à 
poser sur chaque texte à traduire. 


Les traductions seront écrites dans des fichiers textes au format générique 
CSV (une ligne par "valeur" avec chaque ligne composée de colonnes séparées 
par des points-virgules) présents dans le dossier Resources. Dans notre cas il n’y 
aura que deux colonnes : une pour une clé et une pour la valeur traduite. 


s 


Lors de la première lecture d'une valeur à traduire, le script générera un 
dictionnaire "clé/valeur" une fois pour toutes et les valeurs seront lues en son 
sein. 


La première manipulation va donc consister à créer un composant Text et lui 
apposer un script : 


Dans la vue Hierarchy, cliquez Create - UI - Text. 
Sélectionnez le GameObject Text nouvellement créé par Unity. 


Dans l'Inspector, cliquez sur le bouton Add Component et Create Script 
dans la fenêtre de sélection. Choisissez Localize comme nom de script. 
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6.2 Création des fichiers de ressources 


Un fichier de traduction CSV sera créé et édité à l'aide d'un éditeur de texte. 
DOuvrez votre éditeur de texte préféré, par exemple Notepad. 


Ajoutez une première ligne de traduction constituée de "maClefl;ma pre- 
mière valeur" et une seconde ligne "maClef2;ma seconde valeur. 


Créez un dossier nommé Traductions dans le dossier Resources d'Unity. 


Sauvegardez dans ce dossier le fichier précédemment créé sous le nom "Lo- 
calizedText.French.txt". L'extension de fichier "txt" est importante ici. 


Copiez-collez ce même fichier au même endroit en le renommant "Loca- 
lized Text.English.txt" 


BOuvrez cette copie et modifiez les valeurs pour les traduire en anglais. 


Le projet possède maintenant deux fichiers de traductions, un pour l'anglais, 
l'autre pour le français : 
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Lecture du fichier de traduction 


Vous allez maintenant créer dans le script Localize une méthode 
ReadTextAsset permettant de choisir et de lire le bon fichier de traduction. 


Pour déterminer le nom du fichier, utilisez la valeur de la propriété Applica- 
tion.systemLanguage correspondant à la langue du player Unity. La 
méthode Resource .Load permet alors de lire le fichier dans les ressources. 
Celle-ci retourne null1 si le fichier n'est pas trouvé et il faut alors tester cette 
valeur pour charger le fichier correspondant à la langue par défaut (l'anglais 
dans notre cas). 


private static string ReadTextAsset () 
{ 
// Récupération de la langue du player 
string language = Application.systemLanguage.ToString(); 


// lecture du fichier de ressource 

var osResource = "Traductions/LocalizedText." + language; 
Debug.Log(osResource) ; 

var textAsset = Resources.Load<TextAsset>(osResource) ; 


// Si la langue n'est pas prise en charge, 

// passage sur la valeur par défaut 

if (textAsset == null) 

{ 
var fallbackResource = "Traductions/LocalizedText.English" 
textAsset = Resources.Load<TextAsset>(fallbackResource) ; 


} 


if (textAsset == null) 


{ 
} 


return string.Empty; 


return textAsset.text; 


HRemarque 


Attention à ne pas mettre l'extension "txt" dans le nom de la ressource ici. Elle 
est déduite du fait que c'est Un TextAsset qui est chargé. 
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Si d'aventure une langue devait être ajoutée, il suffirait d'ajouter un fichier de 
traduction en déduisant son nom d'une des valeurs de l'énumération retour- 
née par Application.systemLanguage. 


6.4 Interprétation du fichier de ressources 


Créez maintenant une méthode Init qui va interpréter le contenu du fichier 
de texte pour créer un dictionnaire clé/valeur correspondant aux traductions. 
Il s'agit ici d'utilisation de composants classiques du framework .NET. 


private static Dictionary<string, string> textDictionary; 


private void Init() 


{ 
// si déjà initialisé, on ne fait rien 
if (_textDictionary !-= null) 


{ 
} 


return; 


_textDictionary = new Dictionary<string, string>(); 


// Lecture du fichier de traduction 
var fileText = ReadTextAsset (); 


// Si l'on n'arrive pas à lire le fichier 

// on affiche un message dans l'Inspector 

if (string.IsNullOrEmpty(fileText)) 

{ 
Debug.LogError ("Impossible de charger les traductions."); 
return; 


} 


//Lecture du fichier ligne par ligne 
var stringReader = new StringReader (fileText) ; 
string line; 
while ((line = stringReader.ReadLine()) != null) 
{ 
//Découpage de la ligne par rapport au ; 
var array = line.Split(';!); 
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} 


La partie la plus importante est sans doute les premières lignes qui vérifient 
que l'initialisation n'est pas déjà effectuée en vérifiant simplement que le 
dictionnaire n'est pas égal à la valeur nul11. Vous remarquerez que ce dernier 
est déclaré comme static afin d'être partagé par tous les composants 
Localize de l'application. L'initialisation n'est donc faite qu'une seule fois. 


Finalement, il ne reste plus qu'à assigner la valeur traduite au composant 
Text. Pour cela, une méthode utilitaire Get Text ForKey est à ajouter dans 
le script. Il est toujours possible que par erreur la clé n'existe pas dans le dic- 
tionnaire de ressources. Dans ce cas, le script va afficher une erreur dans la 
console et assigner la valeur de la clé au texte. Il est aussi important de déclarer 
la clé de traduction comme champ public du composant. 


//Mauvaise ligne 
if (array.Length < 2) 


{ 
} 


continue; 


// Ajout de la traduction au dictionnaire 
_textDictionary[array[0]] = arrayll]l; 


Assignation de la valeur traduite 


// Clé de traduction à indiquer dans l'Inspector 
public string LocalizationkKey; 


private Text _text; 


void Start () 


{ 


} 


// récupération du composant 
_text = GetComponent<Text> (); 
_text.text = GetTextForKey (LocalizationKey); 


private string GetTextForKey (string key) 


{ 


Enit();; 
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string value; 
if (_textDictionary != null 

&& _textDictionary.TryGetValue(key, out value)) 
{ 


} 


return value; 


// si l'on est ici, la clé n'existe pas 
var format = "La clé '{0}' n'existe pas dans les traductions"; 
Debug.LogWarningFormat (format, key); 


return key; 


} 


Finalement, il est intéressant d'avoir la traduction directement dans la scène 
même en mode édition. Pour cela, utilisez la méthode OnValidate appelée 
par Unity à chaque changement de valeur dans l'Inspector : 


// Mets à jour dans l'Inspector 
void OnValidate() 


{ 
} 


_text.text = GetTextForKey (LocalizationKey) ; 


. Gestion des polices (font) 


Les polices sont des éléments bien à part dans Unity et peuvent être utilisées 
sur un composant Text vu précédemment ou en utilisant le composant his- 
torique GuiText. 


Import d'une police 


Unity supporte les polices de types TTF (True Type Font) et OTF (Open Type 
Font) ainsi que les caractères Unicode nécessaires à l'affichage de texte français, 
japonais ou encore chinois. 


Il suffit de placer un fichier de ce type dans le dossier Asset pour qu'Unity 
l'importe. Ce processus crée automatiquement une texture et un matériau uti- 
lisé par Unity pour faire le rendu de la police là où cela est nécessaire. 
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L'affichage d'un texte consistera à afficher des portions de cette texture. 


Il est possible de configurer l'import de la police depuis l'Inspector : 


— Font Size : taille de base de la police utilisée pour générer la texture corres- 
pondant à la police. Plus cette valeur est grande, plus la texture générée est 
grande mais plus les textes affichés avec une grande taille de police sont 
affichés sans défaut dû à un agrandissement d'une image trop petite. 


- Rendering Mode : mode de rendu utilisé pour générer l'image correspon- 
dant à la police. Permet d'affiner la qualité du rendu si nécessaire. 


- Character : permet de choisir quels caractères seront générés dans la 
texture de la police. Il est possible de ne sélectionner qu'un nombre restreint 
de caractères afin de limiter la taille de la texture créée. À noter qu'Unity fera 
le ménage pour vous en supprimant les caractères redondants. 


— Include Font Data : lorsque Character prend la valeur Dynamic, ce para- 
mètre indique à Unity s'il doit inclure la police dans le player final ou non. 
Cela permet de réduire la taille du package. 


HRemarque 


Attention, les caractères en minuscules et en majuscules sont bien des carac- 
tères différents. En n'utilisant que des minuscules ou des majuscules cela 
permet de jouer sur la taille de la texture finale. 
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7.2 Fonts dynamiques et statiques 


Le paramètre Character est très important car il permet de choisir entre un 
jeu de caractères statique et un jeu de caractères dynamique. 


S'il est dynamique, la texture sera générée à la volée par Unity. Cela a un 
impact sur les performances mais permet d'économiser sur la taille du package 
car il ne contiendra pas de texture prégénérée. 


Si Include Font Data est cochée, la police originale sera utilisée. Si cette 
option n'est pas sélectionnée, Unity tentera de trouver la police dans l'envi- 
ronnement où il est exécuté. Si la police n'est pas trouvée, Unity se rabattra 
alors sur une police par défaut. Ce mécanisme se reproduit aussi pour chaque 
caractère : s'il n'est pas trouvé dans la police choisie, Unity ira le chercher dans 
la police par défaut. 


Remarque 


La police Arial est incluse par défaut dans tous les projets Unity même si elle 
n'est pas visible dans les Assets du projet. 


Si le jeu de caractères est statique, la texture sera générée une fois pour toutes 
par Unity qui l'inclura dans le package final. La taille du package peut ainsi en 
être augmentée de façon sensible et Le jeu de caractères est limité à ceux choisis 
initialement. À contrario il est aussi possible de ne garder que les caractères 
nécessaires et optimiser ainsi le rendu. 


Remarque 


Il est aussi possible de créer sa propre police, c'est-à-dire utiliser une texture est 
associer des zones de celle-ci à un caractère donné mais cela dépasse le 
cadre de ce livre. 
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1. Les jeux multijoueurs 


1.1 Introduction 


La sortie de Unity 5.1 a apporté son lot de nouveautés et parmi elles, un tout 
nouveau système pour créer des jeux multijoueurs : UNET. Plus souple et 
accessible que son prédécesseur, il propose une surcouche d’abstraction à 
toutes les problématiques réseaux afin que le développeur n'ayant aucune ou 
peu de compétence en réseau puisse facilement créer son jeu multijoueur. Le 
but avoué d’Unity étant que tout le monde soit en mesure de créer le 
MMORPG (Mossively Multiplayer Online Role-Playing Game) de demain ! 


Le système se compose de deux parties en fonction des connaissances en 
réseau de l'équipe de développement et du type de jeu souhaité : 


— Pour les utilisateurs novices qui souhaitent simplement faire un jeu multi- 
joueur aisément, les équipes de développement ont fourni la High Level API 
(HLAPD), l'API de haut niveau. 


— Pour les plus expérimentés d’entre nous qui veulent construire toute une in- 
frastructure réseau, optimiser les paquets et plus encore, il faudra se tourner 
vers la NetworkTransport API. 
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L'API haut niveau 


Introduction 


Derrière le nom de code « HLAPT » se cache un moyen d'accéder aux fonction- 
nalités les plus souvent utilisées lors de la création d’un jeu multijoueur en 
oubliant toute la partie bas niveau qui sera gérée toute seule. Voici ce à quoi 
cette APT vous donne accès : 


contrôler l’état du réseau du jeu grâce à la classe NetworkManager, 


céer une partie pouvant accueillir d’autres joueurs, le joueur hébergeant lui- 
même la partie, 


envoyer et recevoir des messages, 


envoyer des commandes du client vers le serveur, 


— passer des commandes RPC (Remote Procedure Call) depuis les serveurs vers 
les clients, 


— envoyer des événements des serveurs aux clients. 


Concept du multijoueur 


Quand on aborde un jeu multijoueur, il est très important d'avoir une vision 
claire du fonctionnement du système manipulant les objets du jeu (joueurs, 
ennemis...), de la synchronisation des données, des différentes connexions. 
Nous allons donc passer en revue ces différents concepts. 


Client ou serveur ? 


Selon les configurations, la différence entre client et serveur peut être difficile 
à cerner. Le serveur permet de gérer le cycle de vie des objets composant le jeu, 
de gérer le début et la fin d'une partie et une grande part de la logique du jeu. 
Lors du lancement du jeu ou d'une partie, le joueur se connecte à l'hôte qui 
héberge le serveur (host) afin de lui notifier sa présence. Le joueur devient alors 
un client. Le serveur peut avoir un grand nombre de clients connectés à lui, il 
sert donc de passerelle pour informer les autres clients des interactions des 
autres clients car il est le seul à recevoir l'intégralité des informations sur ce 
que font tous les clients. 
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Serveur 


Client 


+ client. Client 


Si le serveur n'est pas dédié sur une machine spécifique, il sera automatique- 
ment hébergé par un client. Ce qui donne une situation un peu spéciale avec 
un client se connectant localement au serveur et d'autres s'y connectant à 
distance. 


Client à Client à _ Cilienta. 
distance distance distance 


Le cycle de vie des objets 


Le serveur doit donc gérer beaucoup de choses et notamment le cycle de vie 
des objets de son monde. Dans un jeu classique, la création d'un objet se fait 
simplement en utilisant la méthode Instanciate de la classe GameObject 
ce qui a pour effet d'ajouter celui-ci dans la scène. Vous l'aurez compris, plus 
question de cela dans un jeu multijoueur. Il faut que le serveur ait conscience 
qu'un objet vient d'être créé et la solution la plus simple est de laisser faire la 
création des objets par le serveur. Il pourra gérer toutes les modifications de 
celui-ci, les synchroniser, les envoyer aux clients en ayant besoin, etc. C'est ce 
que l'on appelle communément le spawning. 
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La gestion des autorités 


Tous les objets créés par le serveur ne sont pas gérés uniformément. En effet, 
le joueur a son fonctionnement propre car il est lié directement à un client. 
Lors de la création de notre joueur, le serveur crée une instance de son côté 
puis une autre instance est créée localement chez le client. Il peut être pratique 
de facilement reconnaître notre joueur, c'est pourquoi le système met à dispo- 
sition la propriété isLocalPlayer. Il est donc aisé de lui appliquer une 
caméra ou de jouer un scénario spécifique. 


De plus, il existe une notion d'autorité qui permet de définir qui peut modifier 
les valeurs d'un objet ou non. À la création d'un joueur, une autorité locale lui 
est rattachée lui conférant le contrôle sur cet objet. 


Les objets n'étant pas des joueurs et donc nullement liés à un client seront 
gérés par le serveur directement, qui devient leur autorité par défaut. Il est 
aussi possible dans certains cas, qu'un client prenne l'autorité sur un objet non 
joueur lui permettant alors d'envoyer des commandes comme un joueur 
normal. 


Les principaux composants de l'API 


Toute la couche réseau fait partie intégrante du moteur et de l'éditeur ce qui 
permet d’avoir accès à des composants et des aides visuelles afin de vous assis- 
ter lors de la mise en place de votre jeu. 


Network Manager 


Introduction 


Le composant NetworkManager est utilisé pour gérer l'état d'un jeu multi- 
joueur. Utilisant directement la nouvelle API, il permet de faciliter grande- 
ment la création et le débogage grâce à son intégration avancée dans l'éditeur. 
La grande force de ce composant est qu'il peut être intégralement utilisé sans 
mettre la main dans du code. 


Le composant NetworkManagerHUD qui lui est couplé permet d'afficher une 
fenêtre de configuration très pratique que le joueur peut manipuler directe- 
ment en temps réel. 
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Start Matchmaker (M) 


Le composant NetworkManager peut être utilisé comme le composant prin- 
cipal lors de la création d'un jeu multijoueur car il possède un grand nombre 
de fonctionnalités déjà implémentées comme la gestion des états du jeu, le 
spawning, la gestion des scènes, le matchmaking (partie en mettant en rela- 
tion des joueurs de même niveau). 


Les méthodes principales 

La classe NetworkManager possède un grand nombre de méthodes, souvent 

virtuelles, pouvant être utilisées comme : 

-— GetStartPosition: retourne la position d'apparition de l'objet dans la 
scène. 

— IsClientConnected: retourne si le serveur a au moins un client connecté. 


— OnClientConnect : est appelé sur le client lorsqu'il est connecté à un ser- 
veur. 


— OnClientDisconnect : est appelé sur le client lorsqu'il est déconnecté 
d’un serveur. 


- OnClientError : est appelé sur le client quand une erreur réseau est sur- 
venue. 


— OnServerConnect : est appelé sur le serveur quand un client se connecte. 


— OnServerDisconnect : est appelé sur le serveur quand un client se 
déconnecte. 


— OnServerError : est appelé sur le serveur quand un client rencontre un 
problème réseau. 
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Les propriétés principales 


Une multitude de propriétés sont accessibles dans la classe NetworkMana- 
ger afin de paramétrer son jeu dont voici les principales : 


- autoCreatePlayer : permet de définir si les nouveaux joueurs se connec- 
tant au serveur doivent être créés et ajoutés à la scène automatiquement. 


— isNetworkActive : retourne si le serveur (NetworkServer) ou le client 
(NetworkClient) est actif. 


- matches : retourne la liste des parties disponibles. 


- maxConnections : permet de définir le nombre de connexions maximum 
pouvant être supportées par le serveur. 


— networkAddress : retourne l'adresse à laquelle le client est connecté. 
Retourne l'adresse locale dans le cas d'un serveur. 


- numPlayers : retourne le nombre de clients actuellement connectés. 
Disponible uniquement sur le serveur. 


- playerPrefab : permet de définir le prefab par défaut à utiliser pour la 
création d'un joueur. 


Network Identity 
Introduction 


Le composant NetworkIdentity permet de lier un objet au réseau. Il est 
utilisé pour synchroniser les informations de celui-ci via le réseau. C’est au ser- 
veur que revient la tâche de créer les instances des objets ayant une Networ- 
kIdentity autrement la liaison ne se fera pas correctement avec le système. 


Les objets ayant une identité sur le réseau sont créés à la fois sur le serveur et 
sur le client. Au lancement du jeu, ces objets sont tous désactivés. Une fois la 
connexion avec le serveur effectuée, le serveur envoie la liste des objets de la 
scène devant être activés et les dernières informations les concernant (posi- 
tion, état...). Avec cette méthode, le client est sûr d'avoir les éléments bien 
placés dans la scène. 


© Editions ENI - AII rights reserved 


: Communication réseau et jeux multijoueurs 
Chapitre 10 


Les méthodes 


La gestion de l'autorité comme l'ajout ou la suppression du contrôle d'un objet 
peut être faite via les méthodes suivantes : 


- AssignClientAuthority : permet d'assigner le contrôle d'un objet au 
client. 


- ForceSceneld : permet de forcer l'identifiant de la scène (sceneId) à 
une valeur spécifique. 


— RebuildObservers : permet de reconstruire la liste des clients pouvant 
voir cet objet. 


- RemoveClientAuthority : permet de supprimer le contrôle d'un objet. 


Les propriétés principales 

La classe NetworkIdentity expose des propriétés permettant d'obtenir des 

informations sur l'identité de l'objet : 

- assetId:identifiant unique permettant de retrouver l'asset ajouté dans la 
scène lors de la création d'un client. 


- clientAuthorityOwner : retourne le client ayant l'autorité sur cet objet 
ou null s'il n'en a aucun. 


— isClient : retourne true si l'objet est un client et qu'il a été créé via le 
serveur. 


- isLocalPlayer : retourne true si l'objet est directement lié au joueur de 
la machine courante. 


— isServer : retourne true si l'objet fonctionne comme serveur. 


- serverOnly : permet de définir l'objet comme fonctionnant uniquement 
côté serveur. 
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La classe NetworkBehaviour 


Introduction 


La classe NetworkBehaviour sert, quant à elle, lors de la création de scripts 
voulant utiliser les commandes, les RPC, la synchronisation de variables ou 
d'événements. De nombreux événements sont aussi accessibles comme 
OnStartClient qui permet d’être notifié quand le client se connecte au ser- 
veur. On l'utilise en remplaçant simplement l’héritage de MonoBehaviour 
par NetworkBehaviour. 


Synchronisation des données 


L'ajout de la classe NetworkBehaviour permet de renseigner facilement des 
variables à synchroniser automatiquement en utilisant un attribut. 


[SyncVar (hook = "OnLifeChanged")] 
public int Life; 


private void OnLifeChanged(int value) 


{ 
} 


Pour la, synchronisation de listes d'objets, il faut passer par les classes 
SyncLlist<T>, SyncListInt, etc. 


Debug.Log(string.Format ("(#{0}) a {1} vie(s) !", netId, value) ); 


public class Weapon 


{ 


public int Id; 


public string Name; 


} 


public class MyPlayer : NetworkBehaviour 


{ 


public SyncList<Weapon> Weapons; 
private void Start () 


11 €} 
Weapons.Callback = OnWeaponsChanged; 


} 


private void OnWeaponsChanged (SyncList<Weapon>.Operation operation, 
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int itemIndex) 


switch (operation) 


{ 


} 


case SyncList<Weapon>. 


// TODO 
break; 


case SyncList<Weapon>. 


// TODO 
break; 


case SyncList<Weapon>. 


// TODO 
break; 


case SyncList<Weapon>. 


// TODO 
break; 


case SyncList<Weapon>. 


// TODO 
break; 


case SyncList<Weapon>. 


// TODO 
break; 


case SyncList<Weapon>. 


// TODO 
break; 


Operation. 


Operation. 


Operation. 


Operation. 


Operation. 


Operation 


Operation. 


OP_ADD: 


OP_CLEAR: 


OP_INSERT: 


OP_REMOVE: 


OP_REMOVEAT : 


.OP_SET: 


OP_DIRTY: 


Dans l'exemple ci-dessus, on synchronise une liste d'armes (weapons) grâce à 
la classe générique SyncList<T>.On s’abonne ensuite à l'événement Cal1- 
back pour être notifié des changements effectués sur la liste (ajout, suppres- 


sion...). 
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Les fonctions de rappel 


Les fonctions de callback (rappel) sont utilisées pour avoir accès à des événe- 
ments réseau. Concrètement, ce sont des méthodes virtuelles déclarées dans 
la classe NetworkBehaviour qui peuvent être surchargées comme ceci : 


using UnityEngine; 
using System.Collections; 
using UnityEngine.Networking; 


public class NetworkBehaviourCallback : NetworkBehaviour { 
public override bool OnSerialize(NetworkWriter writer, 
bool initialState) 
{ 


// TODO 


return base.OnSerialize(writer, initialState); 


} 


public override void OnDeserialize (NetworkReader reader, 
bool initialState) 


// TODO 


base.OnDeserialize(reader, initialState); 


} 


Les différentes fonctions de rappel sont : 


- OnStartServer : est appelée lorsqu'un objet est instancié sur le serveur. 
- OnStartClient : est appelée lorsqu'un un objet est instancié sur le client. 


— OnSerialize : est appelée lors de l'envoi de l'état de l'objet du serveur vers 
les clients. 


— OnDeserialize : est appelée lors de la mise à jour de l'état d'un objet vers 
les clients. 


— OnNetworkDestroy : est appelée sur les clients quand le serveur détruit 
un objet. 


— OnStartLocalPlayer : est appelée lorsque l'objet local correspondant au 
joueur a été créé. 
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— OnRebuildObservers : est appelée par le système qui gère la visibilité 
des objets dans la scène afin de reconstruire les observers (observateurs), 
c'est-à-dire, les clients pouvant voir l'objet. 


— OnSetLocalVisibility:est appelée par le système qui gère la visibilité 
afin de mettre à jour la visibilité d'un objet d'un client local connecté à l'host. 


— OnCheckObserver : est appelée par le système de visibilité afin de savoir 
si un observeur peut voir ou non un objet. 


Les fonctions spécialisées 


Il est aussi possible d'ajouter des attributs aux méthodes afin de spécifier si 
celles-ci doivent s'exécuter uniquement côté serveur ou côté client. Cela peut 
être très intéressant lorsque l'on met en place des scénarios complexes ou la 
gestion des animations. 


using UnityEngine; 
using UnityEngine.Networking; 


public class NetworkBehaviourSpecialized : NetworkBehaviour 


{ 


private int coins; 


[Server] 

public void AddCoins (int amount) 

{ 
// Uniquement appelé côté serveur 
coins += amount; 


} 

[Client] 

void PlayAddCoinsAnimation() 

{ 
// Uniquement appelé côté client 
var animator = GetComponent<Animator»> (); 
animator.Play("AddCoins"); 

} 

[ServerCallback] 

void Update () 

{ 


// Uniquement appelé côté serveur 
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} 


[ClientCallback] 
void OnTriggerEnter (Collider collider) 


{ 
} 


// Uniquement appelé côté client 


} 


Dans cet exemple, la seule méthode pouvant modifier la valeur de la variable 
coins est AddCoins qui contient l’attribut [Server]. On fait cela car on 
ne veut pas que le client puisse modifier lui-même cette valeur. En revanche, 
si l’on veut jouer une animation lors du changement de la valeur coins, on 
utilise la méthode PlayAddCoinsAnimation avec l’atttribut [Client], 
car lancer une animation sur le serveur n’a pas de sens. 


Les commandes 


Le système d'autorisation de l'HLAPI permet uniquement au serveur de pou- 
voir faire des choses, les clients ne sont pas autorisés à modifier quoi que ce 
soit par eux-mêmes. Il faut donc un moyen pour ces clients de faire passer des 
ordres au serveur. Cela se fait donc grâce à des commandes. 


Les commandes sont exécutées sur le serveur à partir de l'objet correspondant 
au joueur. Deux choses sont obligatoires afin de déclarer une commande : 
ajouter l'attribut [Command] et utiliser le préfixe Cmd dans le nom de la 
méthode. 


using UnityEngine; 
using UnityEngine.Networking; 


public class NetworkBehaviourCommand : NetworkBehaviour 


{ 


[ClientCallback] 
void Update () 


{ 
float jump = Input .GetAxis ("Space"); 
LE (Jump 510) 


{ 
} 


CmdJump (jump) ; 
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[Command] 
public void CmdJump(float jump) 


{ 
} 


// Mettre à jour les coordonnées de l'objet 


} 
Les appels RPC 


Nous avons vu que les commandes partent du client vers le serveur, les appels 
RPC se font dans le sens contraire. Au niveau du fonctionnement, on peut 
considérer que les appels RPC sont l'inverse des commandes. Toutefois, lors 
du lancement d'un appel RPC à partir du serveur, cela affecte la totalité des 
objets de type NetworkIdentity. 


Deux choses sont obligatoires afin de déclarer un appel RPC : ajouter l'attribut 
[ClientRpc] et utiliser le préfixe Rpc dans le nom de la méthode. 


using UnityEngine; 
using UnityEngine.Networking; 


public class NetworkBehaviourRPC : NetworkBehaviour 


{ 
[ClientRpcl] 
public void RpcShowMessage (string message) 


{ 
} 


[ServerCallback] 
void Update () 


{ 
} 


Debug. Log (message) ; 


RpcShowMessage ("Hello friends !"); 


} 


Les événements 


Dans le même principe que les appels RPC, l'API permet de créer un événe- 
ment (event) qui sera levé à la place d'un simple appel à une méthode. Cela 
est notamment très pratique lorsque l'on utilise différents scripts, car il suffit 
de s'abonner à l'événement afin d'être informé lorsque celui-ci est levé. 
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Deux choses sont obligatoires afin de déclarer un événement : ajouter l'attri- 
but [SyncEvent] et utiliser le préfixe Event dans le nom de l'événement. 


public class NetworkBehaviourEvent : NetworkBehaviour 


{ 


public delegate void PlayerDieDelegate (); 


[SyncEvent] 
public event PlayerDieDelegate EventPlayerDie; 


public int Life; 


[ServerCallback] 
void Update () 


{ 


if (Life <= 0) 


EventPlayerDie(); 
return; 


} 


public class AnotherBehaviour : NetworkBehaviour 


{ 


private NetworkBehaviourEvent _networkBehaviourEvent ; 


[ClientCallback] 
void Update () 


{ 


if (_networkBehaviourEvent == null) 


{ 


_networkBehaviourEvent = GetComponent<NetworkBehaviourEvent> () ; 
_networkBehaviourEvent .EventPlayerDie += OnPlayerDie; 
} 
[Client] 
private void OnPlayerDie() 


{ 
} 


Debug.Log("Player die"); 
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Dans cet exemple, deux classes sont créées : NetworkBehaviourEvent et 
AnotherBehaviour. La première définit un événement qui sera déclenché 
lorsque la propriété Life sera négative. Dans la seconde classe, on récupère 
une instance de la classe NetworkBehaviourEvent grâce à la méthode 
GetComponent afin de pouvoir accéder à l'événement EventPlayerDie de 
celle-ci par la suite. L'abonnement à l'événement se fait ensuite de manière 
classique en utilisant l'opérateur += et en définissant la fonction qui est appe- 
lée lorsque celui-ci sera déclenché, ici OnPlayerDie. Pour se désabonner, il 
faut utiliser l'opérateur -=. 


La classe NetworkTransform 


Introduction 


Dans la plupart des jeux, il existe un grand nombre d'objets en mouvement 
dans la scène. Dans un jeu de type FPS par exemple, notre joueur bouge 
constamment et ses coordonnées sur la carte doivent être réactualisées en per- 
manence. Pour nous aider dans cette tâche, il existe la classe 
NetworkTransform, qui va se charger de faire cette synchronisation pour 
nous automatiquement. 


Dans le cas où l'autorité est locale (dans notre cas, le joueur) la synchronisa- 
tion se fait du client vers le serveur puis vers les autres clients. Dans le cas où 
l'autorité est le serveur (dans notre cas, les ennemis gérés par l'intelligence arti- 
ficielle), la synchronisation se fait du serveur vers les clients. 


L'utilisation de ce composant se fait simplement en l'ajoutant au GameObiject 
ou au prefab que l'on souhaite synchroniser. Celui-ci doit bien entendu avoir 
un composant de type NetworkIdentity rattaché. 


Les propriétés 

- sendInterval : permet de définir le nombre de mises à jour envoyées au 
serveur chaque seconde. 

— transformSyncMode : permet de définir le type de synchronisation à 
utiliser : 
— SyncNone : pas de synchronisation. 


-— SyncTransfrom : la synchronisation se base sur le composant 
Transform de base de l'objet. 
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- SyncRigidbody2D : la synchronisation se base sur le composant 
Rigidbody2D. 

-— SyncRigidbody3D : la synchronisation se base sur le composant 
Rigidbody3D. 

- SyncCharacterController : la synchronisation se base sur le 
composant CharacterController. 


- movement Threshold : permet de définir la distance minimale que doit 
parcourir un objet avant d'envoyer une mise à jour au serveur. 


- snapThreshold : permet de définir la distance pour laquelle l'objet doit 
apparaître de façon immédiate et non de façon lisse. 


— interpolateMovement : permet de définir la vitesse d'interpolation 
entre l'objet et sa nouvelle position. 


- interpolateRotation : permet de définir la vitesse d'interpolation 
entre l'objet et sa nouvelle rotation. Permet de définir les axes à 
synchroniser : 


- None : aucun. 
— AxisX : seulement l'axe X. 
- AxisY : seulement l'axe Y. 
- AxisZ : seulement l'axe Z. 
— AxisXY : seulement les axes X et Y. 
— AxisYZ : seulement les axes Y et Z. 
— AxisXZ : seulement les axes X et Z. 
— AxisXYZ : les trois axes X, Y et Z. 
- rotationSyncCompression : permet de définir le type de compression 
à utiliser lors de la mise à jour des données de rotation : 
— None : aucune compression. 
— Low : compression faible qui préserve la précision des données. 
— High : compression forte qui ampute sur la précision des données. 
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Les méthodes de rappel 


La classe NetworkTransform permet de définir deux callbacks afin de vali- 
der ou modifier la requête de synchronisation. Les deux méthodes, une pour 
la 2D et une autre pour la 3D, prennent en paramètres la position, la vélocité 
et la rotation de l'objet. Ces trois paramètres étant passés par référence, il est 
possible de modifier leurs valeurs directement dans la méthode. Elles retour- 
nent un booléen permettant de valider ou de rejeter complètement la mise à 
jour des données. 


using UnityEngine; 
using UnityEngine.Networking; 


public class NetwokTransformCallback : NetworkTransform 


{ 


public override void OnStartServer () 


{ 
} 


clientMoveCallback2D = CheckMovelnfo; 
public bool CheckMovelnfo(ref Vector2 position, 
ref Vector2 velocity, ref float rotation) 
{ 


if (rotation >= 350 && rotation < 10) 


{ 
} 


return true; 


Debug.Log("Player is looking to North"); 


1.3 Création d'un jeu multijoueur 


1.3.1 Mise en place 


C’est parti pour la création d’un nouveau projet 8D ! Notre but va être de créer 
un jeu pouvant accueillir différents joueurs, de pouvoir rejoindre une partie et 
de se déplacer dans la scène. 
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Pour faciliter la mise en place, nous allons utiliser un prefab du package 
Characters. N'oubliez pas de l'ajouter via le menu Assets - Import 
Package - Characters. 


Ajoutez à la scène un plan qui nous servira de sol puis ajoutez un cube et une 
sphère d’une taille quelconque posés sur le sol qui serviront d'obstacles. 


Création du personnage 


Comme dit précédemment, nous allons utiliser le prefab se trouvant dans le 
dossier Assets\Standard Assets\Characters\FirstPersonCharacter\Pre- 
fabs\FPSController et l'ajouter dans la scène. Renommez-le en Player, réinitia- 
lisez ses propriétés et placez-le correctement dans la scène. Dans l'objet 
Player, ajoutez un nouveau composant de type Capsule puis supprimez son 
composant Collider. À ce stade, si vous testez le jeu, vous devez être en 
mesure de vous déplacer dans la scène. 
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1.3.3 Paramétrage et synchronisation du personnage 


Afin de rendre le personnage utilisable par le système, nous allons devoir lui 
ajouter le composant NetworkIdentity. Ajoutez le composant et cochez 
l’option Local Player Authority car cet objet sera considéré comme étant 
notre joueur. 


Le composant NetworkTransform va maintenant nous être utile pour per- 
mettre de synchroniser la position du joueur. Réglez la propriété Transform 
Sync Mode sur Sync Transfrom afin de baser la synchronisation sur le com- 
posant Trans£orm de notre joueur. 


Pour ne contrôler que son joueur, nous allons devoir créer un script spécifique 
qui n'autorise pas les autres clients à contrôler les autres personnages. Le script 
se présente de cette façon : 


using UnityEngine; 
using UnityEngine .Networking; 
using UnityStandardAssets.Characters.FirstPerson; 


public class NetworkPlayerBase : NetworkBehaviour 


{ 


void Start () 


{ 


if (isLocalPlayer) 
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GameObject .Find("Main Camera") .SetActive (false); 
GetComponent<CharacterController>().enabled = true; 
GetComponent<FirstPersonController>() .enabled = true; 


var fpsCharacter = transform.FindChild("FirstPersonCharacter") ; 


fpsCharacter.GetComponent<AudioListener>().enabled = true; 
fpsCharacter.GetComponent<Camera>() .enabled = true; 


} 


Désactivez sur le player les composants Character Controlleret First 
Person Controller. Dans son objet fils FirstPersonCharacter, 
désactivez la Camera et l’Audio Listener. Tous ces éléments seront réac- 
tivés dans le script uniquement pour notre personnage. 
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Enregistrez le player en tant que prefab afin de le réutiliser plus tard. 


1.3.4 Ajout du Network Manager 


Pour la mise en place de la partie multijoueur, nous allons avoir besoin d’un 
nouvel objet vide que l’on nommera NetworkManager auquel on ajoutera 
deux composants NetworkManager et NetworkManagerHUD. Il servira à 
gérer pour nous toute la logique de connexion client/serveur sans avoir à s'en 
préoccuper. 


Dans le premier composant, on remarque dans la section Spawn Info que 
l'on peut renseigner le prefab à utiliser lors de l'ajout d'un joueur dans la scène 
lorsqu'il se connecte au serveur. Pour pouvoir lier notre prefab Player au 
composant, il doit obligatoirement posséder un composant de type Networ- 
kIdentity. Faites la liaison entre le prefab du joueur et la propriété Spawn 
Info. 
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1.4 UNET Service 


1.4.1 Introduction 


En parallèle de l’API, Unity propose un service hébergé permettant de gérer 
votre jeu en production. Ceci inclut un serveur multijoueur pour permettre à 
votre jeu de communiquer à travers Internet sans avoir besoin d’une adresse 
IP publique. Le trafic réseau passe par un serveur relais hébergé par Unity dans 
le Cloud au lieu de passer directement entre les clients. Ceci évite les pro- 
blèmes avec les pare-feu, permettant aux joueurs de se joindre depuis 
n'importe où. 


Le service fournit aussi la capacité pour les utilisateurs de créer des matchs, 
d'afficher les matchs disponibles pour les rejoindre. 


1.4.2 La classe NetworkMatch 


Pour gérer tout cela dans votre jeu, il suffit d'ajouter le composant Network- 
Match. Celui-ci possède certaines méthodes particulièrement intéressantes : 
- CreateMatch : permet de créer une nouvelle partie hébergée par le client. 


— DestroyMatch : permet de fermer une partie. Possible uniquement pour 
les matchs hébergés par le client. 


— DropConnect ion : permet de fermer la connexion d'un client à une partie. 
— JoinMatch : permet de rejoindre une partie déjà créée. 
- ListMatches : permet de récupérer la liste des parties actives. 


- SetProgramAppID : permet de définir l'identifiant à utiliser pour dialo- 
guer avec le service UNET. Cet appel doit être fait avant toutes autres re- 
quêtes faites au service. 


Grâce à ces méthodes, il est possible de créer un script permettant de gérer la 
1 
gestion des matchs comme celui ci-dessous : 


using UnityEngine; 

using UnityEngine.Networking; 

using UnityEngine .Networking.Types; 
using UnityEngine.Networking.Match; 
using System.Collections.Generic; 


public class HostGame : MonoBehaviour 
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List<MatchDesc> matchList = new List<MatchDesc> (); 
bool matchCreated; 
NetworkMatch networkMat ch; 


void Awake () 


{ 
} 


networkMatch = gameObject .AddComponent<NetworkMatch»> () ; 


void OnGUI () 


{ 


} 


if (GUILayout .Button ("Create Room')) 
{ 
CreateMatchRequest create = new CreateMatchRequest () ; 
create.name = "NewRoom!; 
create.size = 4; 
create.advertise = true; 
create.password = ""; 


networkMatch.CreateMatch(create, OnMatchCreate) ; 


} 


if (GUILayout.Button("List rooms")) 


{ 
} 


networkMatch.ListMatches (0, 20, "", OnMatchList); 


if (matchList.Count > 0) 


{ 
} 


GUILayout . Label ("Current rooms") ; 


foreach (var match in matchList) 


{ 


if (GUILayout.Button(match.name)) 


{ 


networkMatch.JoinMatch(match.networkId, "", 
OnMatchJoined) ; 


public void OnMatchCreate (CreateMatchResponse matchResponse) 


{ 


if (matchResponse.success) 


{ 


Debug.Log ("Create match succeeded") ; 
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} 


matchCreated = true; 

Utility.SetAccessTokenForNetwork (matchResponse.networkId, 
new NetworkAccessToken (matchResponse .accessTokenString)) ; 

NetworkServer.Listen(new MatchIinfo (matchResponse), 9000); 


else 


{ 


} 
} 


Debug.LogError ("Create match failed"); 


public void OnMatchList (ListMatchResponse matchListResponse) 


{ 


if (matchListResponse.success && matchListResponse.matches != null) 


{ 


} 


networkMatch.JoinMatch(matchListResponse.matches [0] .networkId, 
"",OnMatchJoined)) ; 


public void OnMatchJoined (JoinMatchResponse matchJoin) 


{ 


if (matchJoin.success) 


{ 


} 


else 


{ 


} 
} 


Debug.Log ("Join match succeeded) ; 
if (matchCreated) 
{ 
Debug.LogWarning ("Match already set up, aborting..."); 
return; 
} 
Utility.SetAccessTokenForNetwork (matchJoin.networkld, 
new NetworkAccessToken (matchJoin.accessTokenString)) ; 
NetworkClient myClient = new NetworkClient (); 
myClient .RegisterHandler (MsgType.Connect, OnConnected) ; 
myClient .Connect (new MatchInfo (matchJoin) ) ; 


Debug.LogError ("Join match failed"); 


public void OnConnected (NetworkMessage msg) 


{ 


Debug.Log ("Connected!"); 


} 
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Ce script se découpe en plusieurs parties. Tout d’abord, on crée une interface 
graphique permettant de créer une nouvelle partie (network- 
Match.CreateMatch), de lister Îles parties actives (network- 
Match.ListMatches), et enfin la possibilité de les rejoindre 
(networkMatch.JoinMatch). Ensuite, on crée les callbacks pour chacune 
des méthodes appelées auparavant afin de gérer les retours et les erreurs 
(OnMatchCreate, OnMatchList, OnMatchJoined). 


Les classes WWW et WWWForm 


Unity met à disposition une classe permettant de faire des appels HTTP de 
type GET ou POST. La requête ainsi créée s'effectue en arrière-plan ce qui per- 
met de récupérer le résultat une fois le traitement fini, quelques frames plus 
tard. Ceci est particulièrement utile pour appeler une API (Application Pro- 
gramming Interface). 


Requête de type GET 


using UnityEngine; 

using System.Collections; 

using System.Diagnostics; 

using Debug = UnityEngine.Debug; 


public class WWWGet : MonoBehaviour { 


public string url = "http://google.com'; 
IEnumerator Start () 
{ 
Stopwatch watch = new Stopwatch(); 
watch.Start (); 


WWW www = new WWW (url) ; 
yield return www; 


watch.Stop(); 
Debug.Log(string.Format ("{0} bytes downloaded in {1} ms", 
www.bytesDownloaded, watch.ElapsedMilliseconds) ); 
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Ce script fait une requête GET sur la page d’accueil de Google et affiche la 
taille des données récupérées et le temps de réponse de la requête. 


Requête de type POST utilisant la classe WWWForm 


using UnityEngine; 

using System.Collections; 

using Debug = UnityEngine.Debug:; 
public class WWWPost : MonoBehaviour { 


private string url = "http://account.my-server.fr'; 


void Start () 


{ 
} 


IEnumerator Login() 


{ 


StartCoroutine (Login ()); 


WWWForm form = new WWWForm () ; 
form.AddField("username", "Lordinaire"); 
form.AddField("password'", "motdepasse"); 


WWW www = new WWW(url, form); 
yield return www; 


if (!string.IsNullOrEmpty(www.error)) 


{ 
} 
else 


{ 
} 


Debug.Log (www.error) ; 


Debug.Log('"Vous êtes connecté !"); 


} 


Ce script crée une requête POST avec des données de type formulaire (WWW- 
Form) contenant les identifiants d’authentification. Le serveur recevant cette 
requête peut récupérer ces informations afin de vérifier l'identité de l’utilisa- 
teur. 
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1. Le player et les builds : concepts de base 


1.1 Définition 


Unity3D est capable de cibler de nombreuses plateformes. Pour chacune d'elle, 
il est nécessaire de générer un ensemble de fichiers spécifiques appelé une 
"build". Celle-ci contiendra alors tout le nécessaire permettant d'exécuter 
l'application 2/3D développée sur la cible. 


Une build est constituée de deux choses : 


— les fichiers spécifiques (images, sons, ressources, etc.) de l'application 2/3D 
compilés dans un format Unity "binaire", 


— le player (que l'on peut traduire "lecteur" en français) d'Unity capable de lire 
ces fichiers et de jouer les scènes pour la plateforme ciblée. 
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1.2 Différents formats de builds 


2.1 


En fonction de la plateforme, Unity générera différentes choses : 


- Pour Android, un fichier au format APK (Android Application Package) sera 
généré. Celui-ci pourra être soumis directement sur le Store Google (le Play 
Store) ou installé sur un périphérique de test. Unity est aussi capable de gé- 
nérer l'ensemble des projets à utiliser avec le SDK Android. 


— Pour Windows Phone 8.0, Windows 8.1, Windows Phone 8.1, Unity 
générera un ensemble de projets utilisable dans Visual Studio pour générer 
un package (fichier .XAP) à déployer sur le Windows Store ou sur un péri- 
phérique de test. Unity générera aussi des versions de test (avec un splash 
screen et des icônes Unity) pour tester rapidement un comportement. 

- Pour iOS, Unity générera un projet Xcode permettant de générer et 
déployer l'application iOS et de la publier sur le Apple Store. 

- Pour Windows, Mac ou Linux, Unity générera un exécutable et un 
ensemble de fichiers de données directement utilisables pour exécuter 
l'application 2/3D. 

— Pour les différentes consoles (Xbox One/360, PS3/4, PS Vita), Unity 
générera des projets utilisables avec les différents SDK pour générer un 
exécutable spécifique. 

— Pour les projets web, Unity générera un fichier HTML permettant 
d'initialiser le plugin Unity Web Player et de lancer l'application. 

— Pour les projets WebGL, Unity générera un fichier HTML permettant 
d'initialiser le plugin standard WebGL. 


. Configuration du player 


Description 


La configuration du player est peut-être la phase la plus fastidieuse car il y a 
beaucoup de paramètres à vérifier mais c'est sûrement la plus excitante car on 
est dans la dernière étape avant la génération finale de l'application. 
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Unity permet tout d'abord de configurer les paramètres généraux de l'applica- 
tion directement dans l'Inspector. Voici la procédure pour afficher cet écran : 


ACliquez sur Edit dans le menu général d'Unity. 


Sélectionnez Project Settings puis Player. 


Unity {54bit) - Untitied - Code - PC, Mac & Linux Standalone <DX11> 
File : Edit. Assets GameObject Component Window Help 
Undo Inspector Ctri+Z 


Redo CuY ere ; 


Cut CtitX : sé Lt PlayerSettings 
Copy Ctri+C | 
Paste CtrisV 


Duplicate Ctr+ D 
Delete Shift: Del 


Frame Selected F 
Lock View to Selected Shift+F 
Find CtrbeF 
Select Al Ctri+ A 


Preferences. 
Play Ctri+P 
Pause Ctrie Shift+P 


Ctri+Alt+P 


Splash Image 


Other Settings 
Rendering 
Input Rendering Path* 
Tags and Layers Auto Graphics API 
Audio Graphics AP 
Tim 
is 


“ Muitithreaded Rendering* {.; 
Physics Static Batching 1 
Physics 2D Dynamic Batching F4 
Quality GPU Skinning* D 

é Virtual Reality Supported Li 
Graphics 


Network 
Editor 


PAPER NON OI Bundie Version Code 


Les paramètres généraux sont situés dans la partie haute de l'Inspector : 


— Le nom de la société créatrice de l'application 2/3D. 


— Le nom du produit (l'application) développé. C'est cette valeur qui est affi- 
chée dans la barre de titre sous Windows par exemple. 


— Les icônes par défaut. Unity déclinera son utilisation sur toutes les plate- 
formes où cela est possible. 
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La partie basse de l'Inspector permet de configurer spécifiquement le player 
par plateformes. À noter que les configurations des différentes consoles ne 
sont disponibles que si le SDK associé est installé sur la machine de dévelop- 
pement. Pour chacune, les paramètres sont regroupés en plusieurs catégories : 


- Resolution and Presentation : permet de configurer la façon dont est 
affiché le player : plein écran, mode fenêtré, orientations supportées et celle 
par défaut, affichage ou non de la barre de statut. 


— Icon : permet de définir des icônes spécifiques, différentes de celles des 
paramètres généraux. Certaines plateformes nécessitent aussi des icônes 
spécifiques aux tailles bien précises ou encore de définir des paramètres 
associés (nom affiché sur les tuiles, tailles possibles, etc.). 


— Splash Image : choix de l'image de chargement initial du player Unity. 


— Other Settings : tous les paramètres spécifiques à chaque plateforme tels 
que les runtimes supportés, des informations de définition de l'identité du 
package, l'optimisation du player final, etc. 

— Publishing Settings : permet de configurer les paramètres spécifiques à la 
publication finale du package sur les différents stores et notamment les cer- 
tificats à utiliser ainsi que la création des fichiers de description (manifests) 
des capacités de l'application finale. 


HRemarque 


Certains de ces paramètres (indiqués par une petite étoile) sont partagés 
entre plusieurs plateformes. Cela est par exemple le cas de l'orientation par 
défaut. 


SR 


{ Other Settings 


| Publishing Settings 


ee ee 
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Dans la suite, nous allons présenter uniquement les aspects principaux dispo- 
nibles en fonction du type de la plateforme ciblée. 


2.2 Resolution and Presentation (résolution et présentation) 


2.2.1 Plateformes mobiles (Android, iOS, Windows, Tizen...) 


Le paramétrage le plus important est ici de pouvoir choisir les différentes 
orientations possibles supportées par l'application et de spécifier celle par 
défaut. Il est possible de choisir une seule orientation ou d'en cocher plusieurs 
différentes supportées. 


Settings for i0S 
À Resolution and rt à . 


- Orientation 
| Default Orientation* 


Portrait Upside Domn 
Landscape Right 
_ Landscape Left 


Remarque 
Ce paramètre est partagé entre toutes les plateformes mobiles. 
Sur Android et iOS il est aussi possible de configurer l'affichage ou non de la 


barre de statut (la barre affichant la couverture réseau, l'heure et des icônes de 
notification). 


| Status Bar 
_ Status Bar Hidden 


Status Bar Style 
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2.2.2 Plateformes web (Web Player et WebGL) 


Sur ces plateformes, il est principalement possible de configurer la taille du 
player ainsi que le template HTML à utiliser pour le présenter à l'utilisateur. 


Le] 


Settings for Web Player 


Resolution and Presentation 
Resolution . 

Default Screen Width* 

| Default Screen Height* 

Run In Background* 


WebPlayer Template 


lack Backgrou BEM io Context Men 


* Shared setting between multiple platforms. 


Le paramètre Run In Background est aussi intéressant car il permet d'indi- 
quer au player de se mettre en pause lorsque l'utilisateur ne l'utilise plus (chan- 
gement d'onglet, etc.). 


Remarque 


Ilest possible de créer ses propres modèles de page HTML en les plaçant dans 
un dossier WebPlayerTemplates du projet. Unity propose alors un système de 
balises qu'il remplacera lors de la création du player (;UNITY_WEB_NAME# sera 
par exemple remplacé par le nom de l'application). Unity met à disposition 
dans sa documentation le code source du modèle de base et il est souvent 
plus simple de partir de celui-ci pour créer sa propre déclinaison. 
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2.2.3 Plateformes autonomes (PC, Mac, TV...) 


Sur ces plateformes, il est possible de configurer les valeurs par défaut des réso- 
lutions pour être celles natives et pour lancer le jeu directement en plein écran. 
Dans le cas contraire, il est possible de spécifier une résolution par défaut. 


 Defauttis Full Screen 
Default Screen Width 
Default Screen Height 

| Run in Background* 


| Standalone Player Options 

| Capture Single Screen 

_ Display F Resolution D 
Use Player Log 

| Resizable Modem | 
Mac App Store Validation 

ullscreen Mode 

ullscreen Mode 


| Visible h Background 
Force Single Instance 
4 den ne à Rat 
43. 


* Shared setting between multiple platforms.  . 


Voici les champs de configuration les plus importants : 


— Display Resolution Dialog : indique si un écran de choix de résolution est 
affiché lors du lancement. La valeur Hidden permet de ne l'afficher que si la 
touche [Alt] est enfoncée. 


— Use Player Log : indique si les logs du jeu sont écrits dans un fichier 
output_log.txt du dossier Player Data. 


— Resizable Window : indique si le joueur peut redimensionner l'application 
en cours de fonctionnement. 
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- Force Single Instance : indique si une seule instance de l'application peut 
être lancée simultanément. 


- Supported Aspect Ratios : indique de ne proposer que certains ratios dans 
la liste de choix des résolutions. Attention, cela n'empêche pas l'utilisateur 
de redimensionner la fenêtre comme bon lui semble (si la case à 
cocher Resizable Window l'est). 


La fenêtre de configuration des résolutions sur Windows correspond à cet 
écran : 


Code Configuration X 


Graphics Input 


Screen resolution 1024 x 768 v}  MiWindowed 
Graphics quality Fantastic  w ! 
Select monitor Displæy 1 _ | 
Qui 


2.3 Icon (icones) 


2.3.1 Plateformes Windows Store 


Le menu Démarrer à partir de Windows 8 est devenu quelque chose de pré- 
pondérant dans l'univers Microsoft : un ensemble de vignettes dynamiques, 
redimensionnables et présentées comme un aperçu de la vie de l'utilisateur. Il 
va sans dire que ce mécanisme très puissant nécessite d'être configuré. 
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Cela peut bien sûr être fait depuis Unity au sein de plusieurs rubriques de 
l’Inspector : 


— Store Logo : l'icône qui sera utilisée par le Windows Store pour représenter 
votre application. 


- Tile : configuration du texte apparaissant sur les vignettes. Notamment sa 
présence où non et sa couleur. 


- Windows (Phone) Tiles and Logos : les différentes icônes utilisées pour 
représenter votre application sur le menu Démarrer. Ajouter une icône per- 
met à l'utilisateur de redimensionner la vignette dans la taille correspon- 
dante. Certaines tailles (Small Logo et Medium Tile) sont obligatoires. 
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Pour chacune des icônes à fournir, il est demandé quatre fichiers : cela corres- 
pond aux différents plateaux de densité de pixels utilisés par Windows. Il est 
tout à fait possible de ne fournir que les formats "100%" mais ajouter les for- 
mats supérieurs (140%, 180%, etc.) permet de faire apparaître nettement 
l'icône de l'application au lieu de la flouter car Windows l'agrandit. 


Plateformes Windows Phone 8.0 


Cette plateforme permet en théorie la même personnalisation des icônes et 
vignettes au sein du menu Démarrer mais elle n'est malheureusement pas 
intégrée pleinement au sein d'Unity. Il sera donc nécessaire de modifier 
manuellement les fichiers du player générés par Unity après coup. 


cJ LC . 


Settings for Windows Phone 8 


(a 


Resolution and Presentation | 


Icon 
Not applicable for this platform. 


Autres plateformes 


Sur toutes les autres plateformes, soit il n'est pas possible de définir une icône 
personnalisée car cela n'a pas de sens (WebGL et WebPlayer par exemple) 
soit l'icône définie dans les paramètres généraux est utilisée. 


Splash Image (image de démarrage) 


La catégorie Splash Image permet de configurer les différents splash screens 
en images de chargement lors du lancement du player. Il s'agit globalement de 
fournir des images dans des formats spécifiques ainsi que potentiellement une 
couleur de fond si l'image ne correspond pas précisément au ratio de l'écran. 


Un paramètre permet d'indiquer si le splash screen "Unity" est affiché au lan- 
cement. Cela ne peut être désactivé qu'avec la licence pro d'Unity. 


Pour les applications Windows Store, le système de prise en compte de la den- 
sité de pixels est aussi présent. 
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si _ Windows Store 


plash Image 
Show Unity Splash Screen* 


Windows à 
Scale 100% (620x300 pixels) 
Scale 140% (86Bx420 pixel: 
Scale 180% (1116540 pixels) 


Windows Phone  . 
_ Scale 100% (480xB00 pixels) 
| Scale 140% (672x1120 pixels) 
Scale 240% (1152x1920 pixels) 


(joverwrite background coter. 
Background ele 
 * Shared setting between multiple Hans 


Publishing Setting 


2.5 Other Settings (autres paramètres) 


2.5.1 


La catégorie Other Settings est une des plus complètes car elle permet de 
définir beaucoup de paramètres de configuration technique du player et cela 
est très spécifique à chaque plateforme mais des points communs existent. 


Rendering (affichage et technique de rendu) 


La rubrique Rendering permet de configurer le moteur de rendu avec notam- 
ment les propriétés suivantes : 


— Auto Graphics APT : en cochant cette case, vous laissez à Unity choisir 
l'API graphique la plus adaptée pour effectuer le rendu de la scène. Par 
exemple, il utilisera Metal sur les versions d'iOS supérieur à 8.0 et l'ancienne 
API (GLES2) sur les versions précédentes. 


— Static Batching : permet d'activer cette fonctionnalité qui consiste à dessi- 
ner plusieurs objets sur le même appel de rendu. 
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— Dynamic Batching : permet d'activer cette fonctionnalité qui laisse Unity 
optimiser automatiquement le dessin des objets dans la scène. 


Rendering 
Rendering Path* 
Auto Graphics API 
l'Grshien APia _ 
|— OpenGLES2 | 
. + - | 
Multithreaded Rendering* Li - 
Static Batching 
Dynamic Batching (er 
C] 
Ci 


GPU Skinning* 
Virtual Reality Supported 


Remarque 


Ces paramètres ont souvent des valeurs par défaut les mieux adaptées. Il est 
préférable de ne les modifier que si réellement cela corrige ou améliore un 
comportement. 


identification 


Cette rubrique permet de configurer des éléments qui seront utilisés par les 
Stores pour identifier votre application : 


— Bundle Identifier : une chaîne de caractères unique identifiant le package. 
Souvent, on respecte la convention de nommage suivante : "com.So- 
ciete.NomDeLApplication". Attention, il n'est plus possible de le changer 
une fois la première publication effectuée. Dans l'écran ci-dessous, on laisse 
la valeur par défaut d’Unity. 


— Version / Bundle Version Code : identifie le numéro de version de l'ap- 
plication. Il est par exemple nécessaire de l'augmenter avant chaque soumis- 
sion d'une application Android. 


— Minimum API Level : sur Android uniquement, permet de limiter l'appli- 
cation à des OS ayant au minimum une version d'API spécifique. 


| Identification 
Bundle Identifier 


Versian* 
Bundle Version Cade 


Minimum API Level 
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Remarque 


Pour les applications Windows Store, ce paramétrage fait partie de la rubrique 
Publishing. 


2.5.3 Configuration 
Cette rubrique permet notamment de configurer ces deux paramètres : 


— Scripting Backend : indique de choisir Mono2x (ancienne version) ou 
IL2CPP (nouvelle version) lors de la génération du code. Par défaut IL2CPP 
est utilisé et Mono2x n'est plus accepté par les Stores. 


— Device Filter/Target Device : permet de filtrer les périphériques accep- 
tant votre application par architecture de processeur (Android) ou par type 
de format (iPad et/ou iPhone). 


— OS Minimum version : sur iOS, permet d'indiquer la version d'OS mini- 
mum. 


| Configuration 
Scripting Backend 

| Disable HW Statistics 

| Device Filter . 


- SA Define Symbols 


Beaucoup d'autres paramètres sont disponibles ici et sont vraiment spéci- 
fiques à l'usage prévu de votre application : fréquence de l'accéléromètre, uti- 
lisation de l'application en tâche de fond, comportement de la musique par 
rapport au player natif, demande d'utilisation du Wi-Fi, préférence de l'empla- 
cement d'installation, compatibilité avec des plateformes TV, etc. Il serait fas- 
tidieux et inutile de les présenter in extenso ici. 
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2.5.4 Optimization (optimisations) 


La rubrique Optimization permet de modifier des paramètres avancés d'opti- 
misation du player généré et principalement : 


- Api Compatibility Level : niveau d'API utilisé, en limitant celle-ci, une 
plus petite empreinte mémoire est générée. 


— Preload Shaders : permet de précharger tous les shaders au lancement de 
l'application. 

- Preloaded Assets : permet de choisir certains asset à précharger. Très utile 
sur les plateformes web notamment pour s'assurer qu'un asset est bien char- 
gé lorsque l'application se lance. 


— Stripping Level (iOS et Android) : permet de supprimer les morceaux inu- 
tilisés des assemblies générées. Cela peut être fait à plusieurs niveaux : sur 
les assemblies originales, sur le byte code généré ou en utilisant une version 
allégée de mscorlib. Une fois ce paramètre spécifié, il est important de bien 
tester l'application dans son ensemble afin de vérifier qu'il n'y a pas de ré- 
gression. 


Optimization 
Api Compatibility Level 4MNET 2.0 Subset 
Prebake Collision Meshes CO) 
Preload Shaders . 

+ Preloaded Assets 
Stripping Leve* | 
Enable Internal Profiler 


Vertex Compression [Mixed 
Optimize Mesh Data* CL] 


* Shared setting between multiple platforms. 


Remarque 


La section traitant de la réduction de la taille du package plus loin dans ce 
chapitre revient plus en détail sur le mécanisme de stripping. 
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Publishing settings (paramètres de publication) 


Cette zone est présente sur quelques plateformes uniquement et nous revien- 
drons dessus dans la section suivante. 


Génération du package 


Fenêtre de configuration et génération d'une build 


Une fois le player configuré, il est maintenant temps de le générer. Cela se 
passe au travers de la fenêtre Build Settings d'Unity. Voici la manipulation 
permettant d'afficher cette fenêtre : 


ZOuvrir le menu File. 


Sélectionnez le menu Build Settings... 


 Unity (64bit) - Untitled - Code - PC, Mac * sat 


CtriN 
Se Ctrt+-0 È 
Mr de . d6/TouchGesture .unity 
Save Scene Cris 10/10_Localize .unity 
ave dcene n. Ctri-ShifteS 11/SimpleMultiplayerGame.unity 


New Project... 
Qpen Project. 
Save Project 


Web Player 


k tir Staritalarre «4 


402 


3.1.1 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Choix des scènes à inclure 


La partie haute de la fenêtre sert à la configuration des scènes. Il est obligatoire 
d'ajouter au moins une scène pour que la compilation puisse avoir lieu. 


Il y a deux manières d'ajouter une scène à une build : via le bouton Add 
Current qui ajoute la scène actuellement ouverte dans l'éditeur dans la liste 
des scènes à compiler ou en faisant un glisser-déposer du fichier représentant 
une scène depuis la vue Project vers la fenêtre Build Settings. 


Unity assigne un index (commençant à 0) à chaque scène ajoutée et il sera pos- 
sible de s'y référer pour les charger pendant l'exécution de l'application bien 


qu'il soit plus maintenable de s'y référer par leur nom. Il est possible de réor- 


3.1.2 


3.1.3 


donner les scènes par glisser-déposer dans la liste. 


La scène avec l'index 0 sera la première chargée au lancement de l'application. 


Choix de la plateforme 


Dans la partie basse, la liste de gauche recense toutes les plateformes sur les- 
quelles le jeu pourra être compilé. Actuellement, Unity gère pas moins de 17 
plateformes : Web Player, PC, Mac, Linux, iOS, Android, BlackBerry, Tizen, 
Windows Store, Windows Phone 8, WebGL, PS3, PS4, PS Vita, Xbox 360, 
Xbox One et Samsung TV. 


Pour basculer d'une plateforme à une autre, il suffit de sélectionner la nouvelle 
plateforme et de cliquer sur le bouton Switch Platform en bas à gauche de la 
fenêtre. Unity recompile alors les différents assets pour cette plateforme. La 
plateforme sélectionnée est matérialisée par un petit logo Unity à droite de 
son nom. 


Configuration du type de build 


La zone en bas à droite permet de configurer le type de build à produire. Pour 
une application Windows Store, il est par exemple possible de choisir le SDK 
à utiliser et le type de périphérique ciblé (Windows, Windows Phone, les 
deux). 
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La case à cocher Development Build est présente sur la majorité des plate- 
formes et permet d'activer la présence du Profiler ou non dans le player final. 
En la cochant, l'option Autoconnect Profiler apparaît. Cette option rédui- 
sant les performances de l'application, elle est bien sûr à utiliser que dans les 
phases d'optimisation de celle-ci. 


3.1.4 Qu'y a-t-il dans mon package ? 


Il est possible d'ajouter énormément d'éléments dans un projet et pourtant 
Unity n'ajoutera que ce qui est nécessaire dans la build finale. 


Pour cela il va parcourir la liste des scènes incluses, les ouvrir et lire la liste des 
GameObjects pour déterminer les éléments à inclure. À noter qu'il est aussi 
possible d'exclure un élément manuellement en lui assignant le tag Edito- 
rOnly dans l'Inspector. 
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HRemarque 


Comme indiqué dans le chapitre traitant des différents assets, tous les élé- 
ments du dossier Resources sont aussi ajoutés au package final. 


Génération plateforme par plateforme 


Pour chacune des plateformes, Unity va générer un livrable spécifique : pac- 
kage précompilé, projet de développement et/ou les deux en même temps. 


Génération d'un package Android 


Unity permet de créer directement le binaire final correspondant à l'applica- 
tion ou de générer des projets de développements utilisables dans l'environne- 
ment de développement Google (Android Studio). 


Installation du SDK et configuration d'Unity 


Afin de pouvoir générer un package Android, il est nécessaire d'installer le SDK 
Android ainsi que l'environnement de développement Java (JDK). Les 
dernières versions de ceux-ci peuvent être téléchargées à cette adresse : 
http://developer.android.com/sdk 


Une fois installé, il faut indiquer à Unity où se trouve le SDK en suivant cette 
manipulation : 


ACliquez sur le menu Edit puis choisissez Preferences. 
Dans la fenêtre qui s'ouvre, choisissiez External Tools. 


Dans le bas de l'écran, renseignez le chemin vers les répertoires racines du 
SDK d'Android et du JDK. 
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Unity Preferences 


4.1.2 Génération du package 


La génération du package se fait au niveau de l'écran Build Settings en 
cliquant sur le bouton Build. En cochant la case Google Android Project, 
Unity générera un projet de développement Android. En la laissant décochée, 
il produira directement un binaire final (.APK). 
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Build Settings 


Unity vous demandera alors l'emplacement de stockage des éléments générés 
pour commencer la génération. Une fois celle-ci terminée, Unity ouvre 
l'emplacement de génération. 


© Editions ENI - All rights reserved 


Génération et déploiement de package 407 
Chapitre 11 


4.1.3 Signature du package 


Lorsque vous souhaitez publier sur le Store Google, il est nécessaire de signer 
votre package avec un certificat. Unity vous seconde dans cette tâche qui se 
passe en deux étapes : la création du magasin de clés (Keystore) protégé par 
mot de passe et la création d'une clé en elle-même dans ce magasin. 


Voici la manipulation permettant de générer une clé dans un nouveau magasin : 
Rendez-vous dans les paramètres du player Android. 


Sélectionnez le groupe Publishing Settings. 


 Passmord 


Split Application Binary 


us ei 


Cochez la case Create New Keystore. 


Cliquez sur le bouton Browse Keystore et sélectionnez un dossier où placer 
le keystore. 


DSaisissez un mot de passe ainsi que sa confirmation. 


Dans la sous-zone Key, cliquez sur la liste déroulante Alias et sélectionnez 
Create a new key. 
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La fenêtre de création d'une clé s'ouvre : remplissez tous les champs et cli- 
quez sur Create Key. Il est recommandé de choisir un mot de passe diffé- 
rent de celui du keystore. 


La clé est dorénavant créée et vous pouvez la choisir parmi les alias dans la liste 
déroulante. 


Remarque 


Il est important de stocker très précieusement ce certificat et son mot de 
passe : en cas de perte, il sera impossible de publier une mise à jour de votre 
application. Je répète : ne perdez pas ces deux éléments ! 


Lors de la génération d'une mise à jour, il sera nécessaire de choisir à nouveau 
ce fichier keystore, de taper le mot de passe correspondant et de choisir la clé 
utilisée pour la mise en production initiale. 
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| Publishing Settings 


Keystore . 
Muse Existing Keystore [Create New keystore 


m tore JD:/Synched/Dropbox/Ecriture & Relectures/Livres/ur || 
Keystore password 
Confirm passnord 


Key 
Alias 
Password 


Split Application Binary 


Génération d'une application iOS 


Unity propose de créer un projet de développement Xcode permettant de 
générer une version iPhone ou iPad de l'application. Pour cela, il est nécessaire 
d'être sur Mac OS et d'installer Xcode sur cette machine. La dernière version 
de celui-ci pouvant être trouvée à cette adresse : https://developer.apple.com/ 
xcode/. 


Génération du projet Xcode 
La génération du projet est très simple : 
Sélectionnez iOS comme plateforme dans l'écran Build Settings. 


Cliquez sur Build et sélectionnez un dossier où placer le projet Xcode. 


Support de la version 64 bits d'iOS 


Depuis début janvier 2015, Apple impose la soumission de package au format 
64 bits dans son Store. Unity supporte cette technologie depuis sa version 4.6 
mais il est nécessaire de s'assurer qu'elle est bien activée. Pour cela, il faut acti- 
ver le runtime IL2CPP à la place de Mono2x dans les paramètres du player iOS 
en suivant ces manipulations : 
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Rendez-vous dans les paramètres du player iOS. 
Sélectionnez le groupe Other Settings. 


D Dans le sous-groupe Configuration, choisissez IL2CPP comme Scripting 
Backend. 


Configuration 
Scripting Backend 


Target Device 
Target Resolution 
Target SDK 


Génération d'une application Windows Store 


Unity permet de générer des projets de développement utilisables dans l'envi- 
ronnement de développement Microsoft (Visual Studio). 


Installation et activation du SDK Microsoft 


Avant toute chose, il est nécessaire d'installer le SDK Windows 8.1 disponible 
au travers de Visual Studio dans sa version 2018 au minimum. Il est possible 
de télécharger une version gratuite de Visual Studio sur http://visualstu- 
dio.com. De plus, cette installation ne peut être faite que sur Windows 8.1 ou 
supérieur. 


Finalement, il est nécessaire d'activer une licence développeur sur la machine. 
Durant ce processus, un compte Microsoft (n'importe quel compte fera 
l'affaire) vous sera demandé. Voici la manipulation permettant l'activation : 


Dans le menu Démarrer, tapez PowerShell. 


Dans les résultats de recherche, faites un clic droit sur Windows 
PowerShell et sélectionnez Exécuter en tant qu'administrateur. 


Dans la fenêtre s'ouvrant, tapez Show-WindowsDeveloperLicenseRe- 
gistration puis validez avec la touche [Entrée]. 


Suivez alors les instructions dans la fenêtre qui s'ouvre (une connexion 
Internet est nécessaire). 
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4.3.2 Génération du package 
Dans la fenêtre de génération du package, vous pouvez choisir parmi ces SDK : 


— 8.0 : uniquement Windows Store et cela est marqué comme obsolète. 

— 8.1 : uniquement Windows Store. 

— Phone 8.1 : uniquement Windows Phone 8.1. 

— Universal 8.1 : Windows Store 8.1, Windows Phone 8.1 ou les deux à la fois. 
- Universal 10 : application universelle Windows 10. 


Il est possible de cocher la case Unity C# projects afin d'inclure les projets 
de code contenant les scripts à la solution Visual Studio. 


En cliquant sur le bouton Build, Unity vous demande un dossier où stocker 
les fichiers produits : une solution Visual Studio contenant un projet Win- 
dows 8.1, un projet Windows Phone 8.1 et un projet partagé (Shared) si vous 
choisissez Universal 8.1. 


Voici par exemple le contenu pour une application nommée Code : 


.5@ ©0988 +[- 
Search Solution Explarer Cocle « WSA (Ctle | P - 
#1 Solution ‘Code’ (3 projects) 
| 4  CodeShared 
lb  # Properties 
b # Data 
b D Appraml 
| b 


pus MainPagexaml  . 


“# feferences 
Hi Assets 
#} Data 
#i Unprocessed 
M1 Package. appmanifest 
F3 WSAtestCertificate pi 
ne ES Code WindowsPhone [Windows Phone 8.1} 


b 
b 4 Data 
> 


fit 
| 
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Voici la manipulation permettant de lancer votre application sur votre propre 


PE 


Double cliquez sur le fichier d'extension sin présent dans le dossier de géné- 


ration et laissez Visual Studio s'ouvrir. 


Faites un clic droit sur la solution et choisissez l'élément Properties. 


Sélectionnez la zone Configuration Properties. 


Dans le haut de la fenêtre, choisissez l'architecture de votre PC : x86 ou 


X64. 


Cliquez sur OK pour appliquer les modifications et fermez cette fenêtre. 


Dans le menu Debug de Visual Studio, choisissez Start Debugging. 


Solution Code’ Property Pages 


: Code WindowsPhone Debug x86 


P Common Properties Project contexts (check the project configurations to build or deploy): 
4 Configuration Properties es 
 . ; . : Project Configuration Platform Build Deploy | 
| Code. Windows Debug | + | x86 »| 
# f 


? X 


HRemarque 


Attention, il est important de ne pas avoir de caractères spéciaux (tels que &) 
dans l'emplacement de votre projet Unity pour que cette procédure fonc- 


tionne. 
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La génération d'un package à destination du Store dépasse le cadre de ce livre 
mais c'est une procédure détaillée sur les sites MSDN de Microsoft. 


4.4 Génération d'une application autonome (standalone) 


La génération d'une application autonome produit un exécutable directement 
utilisable sur la plateforme cible. En cliquant sur le bouton Build, Unity vous 
demande un dossier où placer l'exécutable : prenez bien garde de le placer dans 
un dossier lui étant réservé car Unity génère d'autres fichiers à ses côtés. 


Dans le cas d'une application "MonApp" sur Windows par exemple, cela sera : 


— l'exécutable (MonApp.exe) lui-même, 

— un dossier MonApp_Data contenant les ressources spécifiques à Unity, 

— si c'est une build de développement, un fichier d'extension pdb pour aider 
au débogage. 


Lorsque vous souhaitez diffuser votre application, il faut fournir l'exécutable 
mais aussi le dossier Data généré. 


4.5 Génération d'un player web 


La génération du player web consiste à la création de deux fichiers par Unity : 
— un fichier WebPlayer.html qui peut être renommé à souhait contenant de 
quoi initialiser le plugin Unity et charger l'application, 


— un fichier WebPlayer.unity3d contenant votre application qu'il ne faut pas 
renommer. 


HRemarque 


Attention, le plugin Unity utilise des API dépréciées dans les navigateurs les plus 
récents (à partir de Google Chrome 45 par exemple) et ne sera donc pas 
compatible avec eux. 
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4.6 Génération d'un player WebGL 


Cette plateforme est encore en preview mais il est déjà possible de tester la 
génération de package qui produira les fichiers suivants : 


— un fichier index.html permettant d'afficher et d'initialiser l'application, 


- un fichier htaccess permettant de définir les droits d'accès aux fichiers du 
player sur le serveur, 


— des dossiers Release, Compressed et TemplateData contenant les assets 
nécessaires au player et à votre application. 


En déployant ces trois éléments sur un serveur web, vous pouvez tester le 
rendu en accédant au fichier index.html. 


HRemarque 


Vous constaterez que la génération de cette plateforme est particulièrement 
longue : n'ayez crainte, cela est normal ! 


5. Personnaliser le processus de build 


Lorsque vous utilisez le bouton Build de l'écran Build Settings, Unity va 
faire ce que l'on appelle une build standard. Cela peut être intéressant pour 
plusieurs raisons : 


— exécuter un utilitaire avant ou après que le player ne soit généré par Unity, 


— copier-coller des fichiers à côté du player, par exemple une documentation 
ou une procédure d'installation de l'application, 


— modifier des assets utilisés par l'application finale : icônes, etc. 


Par exemple, lors de la génération d'une build Windows Phone 8.0, Unity va 
créer pour vous un fichier de manifest et des icônes, un splash screen par 
défaut car cela n'est pas configurable au niveau du player. Il est possible de les 
écraser ensuite sur votre poste de développement au moment de générer le 
package final mais si un autre développeur génère une build depuis Unity, il 
n'aura pas vos modifications. Une solution consiste à stocker les fichiers 
nécessaires sur le gestionnaire de code source et de personnaliser la build pour 


les copier-coller à chaque build. 
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Déclencher le processus de build 


Création d'un élément de menu 


Pour déclencher le processus de build, il est nécessaire de créer un élément de 
menu dans Unity. Pour cela, nous allons suivre la procédure décrite dans le 
chapitre Éditeur, pièce maîtresse en utilisant les attributs Menultem : 


Dans la vue Projects, faites un clic droit puis sélectionnez Create - C# 
script. 


DNommez ce fichier CustomBuild et double-cliquez sur ce fichier pour 
l'ouvrir dans l'éditeur de code. 


Dans le script, supprimez tout le contenu de la classe et ajoutez une mé- 
thode statique Bui1dGame ne prenant rien en paramètre et ne retournant 
rien (void). 


DAjoutez cet attribut sur cette méthode : [Menultem("Outils/Windows 
Phone Build')] 


Le fichier résultant est le suivant : 


public class CustomBuild : MonoBehaviour 


{ 
[Menultem("Outils/Windows Phone Build'")] 
Public static void BuildGame() 
{ 
} 
} 


Récupérer les différentes scènes à inclure 


Le prérequis principal pour la construction du player consiste à-récupérer la 
liste des scènes à intégrer. Pour cela Unity propose dans le namespace Uni - 
tyEditor une classe EditorBuildSettings comportant une propriété 
statique scenes retournant la liste des scènes. Nous allons utiliser une 
requête LinQ de .NET pour filtrer cette liste et ne garder que les chemins 
(path) des scènes activées sous la forme d'un tableau. 
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Voici le code correspondant placé dans une méthode utilitaire GetScenes- 
Path: 


private static string[]l GetScenesPath() 


{ 
string[] scenes = EditorBuildSettings.scenes 
// uniquement les scènes activées 
.Where(s => s.enabled) 


// récupération du chemin vers le fichier 
.Select(s => s.path) 


// transformation en tableau 
.ToArray (); 


return scenes; 


HRemarque 


Il sera donc toujours nécessaire de se rendre dans l'écran Build Settings pour 
configurer les scènes et l'ordre de celles-ci. 


Récupérer le chemin de compilation 


Le deuxième prérequis à la compilation est de connaître un emplacement où 
placer les fichiers. Deux écoles s'affrontent ici : demander à l'utilisateur ou lui 
forcer la main avec un choix plus structuré. Profitons-en pour faire les deux en 
demandant un dossier racine où placer les fichiers finaux dans une hiérarchie 
structurée. 


Pour cela, il est possible d'utiliser les propriétés statiques de la classe Player- 
Settings pour lire des informations sur le player généré (le numéro de ver- 
sion par exemple) et la méthode statique SaveFolderPanel de la classe 
EditorUtility pour demander un emplacement de sauvegarde. Voici le 
code correspondant : 


private static string GetBuildPath(BuildTarget target) 


{ 


n 


// Demandons un dossier racine à l'utilisateur 
string rootPath = EditorUtility.SaveFolderPanel 
("Emplacement racine où stocker les builds.", "", nn); 
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// Formatons une hiérarchie structurée 

var endPath = string.Format ( 
"/Builds/{0}/{1}/{2}", 
PlayerSettings.bundleVersion, 
target, 
PlayerSettings.bundleldentifier); 


return rootPath + endPath; 


} 


La méthode utilitaire prend en paramètre la plateforme ciblée par la build afin 
d'être le plus générique possible. 


5.1.4 Lancer la compilation 


Il ne reste alors plus qu'à lancer la compilation en lui passant les différents 
paramètres que nous venons de récupérer. La méthode BuildGame devient 
donc : 


[Menultem("Outils/Windows Phone Build")] 
public static void BuildGame() 


{ 


var scenes = GetScenesPath(); 
var buildPath = GetBuildPath(BuildTarget.WP8Player) ; 


BuildPipeline.BuildPlayer ( 
scenes, 
buildPath, 
BuildTarget.WP8Player, 
BuildOptions.ShowBuiltPlayer | BuildOptions.Development) ; 


HRemarque 


Le dernier paramètre de type Buildoptions permet de configurer le com- 
portement de la build si nécessaire. Dans cet exemple, il affiche le dossier du 
player et active le mode développement. 
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5.2 Appeler un processus/utilitaire externe 
ou lancer l'application 


Le lancement d'un processus externe relève d'une utilisation classique du fra- 
mework .NET mais il est bon de le rappeler : il suffit de créer un objet de type 
Process et de le démarrer en appelant la méthode Start. 


Voici, par exemple, le code permettant d'ouvrir Notepad sur un fichier 
readme.txt placé à côté de la build : 


var buildPath = GetBuildPath(BuildTarget.WP8Player) ; 
var proc = new System.Diagnostics.Process(); 


proc.StartInfo.FileName = "notepad'" ; 
proc.StartInfo.Arguments = buildPath + "/readme.txt"; 


proc.Start(); 


5.3 Copier-coller différents fichiers 


L'accès aux fichiers se réalise aussi à l'aide des méthodes statiques de la classe 
File du framework .NET. L'information la plus capitale à connaître à ce 
stade est que le chemin vers les données de l'application est disponible dans la 
propriété statique dataPath de la classe Application. 


Voici un exemple permettant de remplacer le splash screen par défaut d'Unity 
par une image placée dans un dossier BuildSettings lors d'une build personna- 
lisée : 
var replace = string.Concat (Application.dataPath, 
"/../BuildSettings/WP8/SplashScreenImage. jpg"); 


var current = string.Format ("{0}/{1}/SplashScreenImage.;jpg", 
buildPath, PlayerSettings.bundleldentifier); 


if (System.I10.File.Exists(replace)) 


System.10.File.Copy(replace, current, true); 
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5.4 Exécuter un script à la fin d'une build 


6.1 


Finalement, il est possible de demander à Unity d'exécuter un script à la fin de 
chaque processus de build. Pour cela, il est nécessaire de placer un attribut 
PostProcessBuild sur une méthode prenant en paramètre la plateforme 
cible ainsi que le chemin de génération. Voici un script d'exemple permettant 
d'afficher un message dans la console à la fin de chaque Build : 


[UnityEditor.Callbacks.PostProcessBuild(1)] 

public static void OnPostprocessBuild(BuildTarget target, 
string pathToBuiltProject) 

{ 


Debug.Log("Build terminée : " + target + " - " 4 
pathToBuiltProject); 


. Créer son propre plugin 


La création de plugin est un sujet bien trop complexe pour être abordé dans 
son intégralité dans ce livre. La vocation de cette partie est de vous en donner 
un aperçu. 


Le principe des plugins 


Un Plugin Unity est un composant n'étant utilisable que sur une plateforme 
cible donnée écrit dans le langage natif de celle-ci : 


— Sur Android, un plugin sera par exemple réalisé à l'aide du Native SDK 
(NDK). 

- Sur iOS, un plugin sera réalisé à l'aide de C++ (.cpp) ou d'Objective-C 
(.«mm). 

— Sur Windows Phone 8.0, un plugin sera réalisé en Silverlight pour Windows 
Phone. 


419 


420 


6.2 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


Par défaut, il est recommandé de placer les fichiers correspondants aux plugins 
dans le dossier /Assets/Plugings/[NomDeLaPlateforme]/. Dans ce cas, Unity 
va automatiquement détecter la plateforme ciblée par le plugin. Le plugin ne 
sera alors disponible que sur le player ciblé. Depuis Unity 5.0, il est possible de 
placer les plugins à n'importe quel niveau de la hiérarchie de dossier du projet 
mais il devient alors nécessaire de spécifier manuellement la plateforme ciblée. 
Un formulaire dédié à cette tâche apparaît alors dans l'Inspector : 


Any Platform 
Editor 
Standalone 
 WebPlayer 


WebPlayerStreamed 
108 
Android 

WebGL 
 WSAPlayer 
WPSPlayer 
Tizen 


Utilisation d'un plugin Android 


Afin de pouvoir utiliser une méthode déclarée dans un plugin Android, il est 
nécessaire de la faire connaître à Unity. Cela est réalisé à l'aide de l'attribut 
DllImport à apposer sur la définition d'une méthode correspondant à la 
signature de celle du plugin. 


Imaginons par exemple que le plugin Android définit une méthode Fonc- 
tionDuPlugin prenant en paramètre un float. Il est alors possible de 
déclarer cette méthode de cette manière dans le code : 


#if UNITY ANDROID 

[DilImport ("NomDuPlugin")] 

private static extern void FonctionDuPlugin (float input); 
#endif 
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HRemarque 
Cette méthode n'étant disponible que sur Android il est important d'utiliser les 


conditions de précompilation #if UNITY_ANDROID afin de limiter la présence 
de la méthode à cette seule plateforme. 


Il est alors possible d'appeler cette méthode depuis votre script de la même 
manière que si cela était une méthode C# d'Unity. 


Utilisation d'un plugin iOS 


Appel d'un plugin standard 


Sous iO, le principe est similaire et il faut déclarer une méthode d'un plugin 
en utilisant l'attribut DllImport mais en spécifiant cette fois-ci 
__Internal comme paramètre car le code natif est lié statiquement sur 
cette plateforme. 


#if UNITY_i0S 

[DllImport ("__ Internal")] 

private static extern void FonctionDuPlugin (float input); 
#endif 


Intégration automatique de code source Objective-C 


De même il est bon de savoir que tous les fichiers .a, .m, .mm, .c ou .cpp pré- 
sents dans le dossier /Assets/Plugins/iOS seront intégrés directement dans le 
projet Xcode final. Cela permet d'ajouter du code natif Objective-C dans le 
projet Unity sans autre travail. 


Voici par exemple le contenu d'un fichier NativePopup.m pouvant être ajouté 
dans ce dossier : 


#import <Foundation/Foundation.h> 


void showNativeAlert( const char* title, const char* message) 
{ 
UIlAlertView *alert = [[UIAlertView alloc] 
initWithTitle: [NSString stringWithUTF8String: title] 
message: [NSString stringWithUTF8String: message] 
delegate:nil 
cancelButtonTitle:@"OK" 
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otherButtonTitles:nil]; 
[alert show]; 
[alert release]; 


} 


Il est alors possible de l'appeler pour afficher une popup "native" sur la plate- 
forme iOS en utilisant ce code : 


#if UNITY_iOS 
[System.Runtime.InteropServices.DllImport ("__ Internal")] 
extern static public void showNativeAlert (string title, 
string message) ; 


showNativeAlert ("un titre", "un message"); 
#endif 


6.4 Création d'un plugin Windows Phone 8.0 


La création d'un plugin sur les plateformes Windows est un peu différente car 
Unity utilise lui aussi .NET pour s'exécuter. 


Le principe de déclaration d'un plugin est alors réalisé à l'aide de deux DLL 
différentes : 


— Une implémentation factice sous la forme d’une DLL .NET 3.5 à placer dans 
le dossier Plugins. Celle-ci sert uniquement à définir les méthodes dispo- 
nibles dans le plugin. 


— L'implémentation réelle sous la forme d’une DLL Silverlight WP 8.0 à placer 
dans le dossier Plugins/WP8. Lorsque vous sélectionnez cette DLL dans la 
vue projet, il est alors nécessaire de spécifier que le placeholder correspond à 
la DEL factice placée dans le dossier Plugins en la sélectionnant dans le 
champ Placeholder de l’Inspector. 
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Voici un exemple de configuration pour un plugin nommé IS.UnityHel- 
pers.GoogleAds.WP.dil : 


On peut voir que la plateforme WP8 est cochée et que la DLL factice est sélec- 
tionnée dans le champ Placeholder. 


. Exécution des scripts : que se passe-t-il sous le capot ? 


Jusqu'à présent : Mono 


Jusqu'à sa dernière version Unity utilisait Mono sur ces différents players afin 
de permettre l'exécution des scripts C#. Cela signifie que sur les 23 plate- 
formes supportées, les équipes Unity se chargeaient de proposer une plate- 
forme d'exécution (CLR - Common Language Runtime) du code .NET supporté 
par Mono. Cela est assez spectaculaire mais présente certaines limitations 
reconnues par les équipes Unity : 


— Les performances de .NET ne sont pas aussi bonnes que celles du code natif 
CFr+. 
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— Mono étant un portage de la CLR sur les plateformes, il a toujours un train 
de retard par rapport aux versions actuelles de .NET : toutes les dernières 
fonctionnalités ne sont pas présentes. À titre d'exemple, à l'heure actuelle, 
Unity ne supporte que la version 8.5 du framework .NET. 


— Le garbage collector spécifique à .NET peut provoquer des problèmes de 
performances dans des applications de type 2/3D. 


Pour répondre à ces problématiques, Unity a décidé de mettre en branle un 
nouveau chantier audacieux : IL2CPP. 


Le futur : IL2CPP 


Concrètement cela consiste en un compilateur AOT (Ahead Of Time) et une 
machine virtuelle qui correspondent à une implémentation de la CLI (Common 
Language Infrastructure) similaire à .NET/Mono. Le programme transforme du 
code IL (Intermediate Language - généré par le compilateur Mono qui est 
conservé) en code C++ pour qu’il puisse ensuite être finalement compilé dans 
du code natif sur chaque plateforme. 


Les étapes de transformation du code sont réalisées dans cet ordre : 


— récupération des scripts du projet C#, UnityScript, etc. 


— transformation en bytecode (code IL) via les compilateurs "classiques" (via 
Mono pour le C# par exemple). 


— conversion du code IL en code C++ via il2cpp.exe. 


— compilation du C++ suivant la plateforme ciblé (Emscripten, Xcode….). 


C# 
user Scripts 


UnityScript 
user scripts 


IL Assemblies 
{UnityEngine.dil, 
UnityEngine.Ul.dil, 
asset store packages) 
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Remarque 


Le code IL est un code pouvant être porté sur toutes les plateformes suppor- 
tées par la plateforme d'exécution de .NET/Mono. Il est aussi indépendant du 
processeur que de l'OS et doit être interprété par une CLR (Common Lan- 
guage Runtime). 


On parle donc bien de compilation AOT car le code est compilé une fois pour 
toutes sur la machine du développeur et n'est pas interprété à l'exécution sur 
la machine de l'utilisateur. 


Les tests réalisés par Unity annoncent des gains de performances de 200 % à 
300 % par rapport à Mono. Cela est principalement dû aux facteurs suivants : 


— Le code est compilé à l'aide de compilateur C++ bien plus ancien et perfor- 
mant en termes d'optimisation du code donné en entrée par rapport au com- 
pilateur Mono/.NET classique. 


— L'analyse statique du code C++ permet aussi de réduire la taille des librai- 
ries finales. 


À ce jour, Unity propose d'utiliser IL2CPP sur deux plateformes : WebGL et 
iOS. Preuve de la confiance d'Unity en sa technologie, il est même obligatoire 
d'utiliser, comme nous l'avons vu auparavant, IL2CPP pour pouvoir publier 
sur le store Apple une application iOS. 


Dans le futur, Unity continuera de miser sur Mono pour transformer les dif- 
férents scripts .NET en IL mais va faire évoluer IL2CPP pour transformer cette 
IL en un code C++ compatible sur un maximum de plateformes. 


. Réduction de la taille du package 


Il est toujours intéressant de réduire la taille du package correspondant à 
l'application afin de faciliter les solutions de déploiement ou ne pas dépasser 
les limites imposées par les Stores (un package de plus de 99 Mo ne peut pas 
être téléchargé en 3G sur un iPhone). À titre d'information, un package Unity 
vide ciblant iOS fera au minimum 22 Mo et 12 Mo si les différentes optimisa- 
tions de code sont appliquées. 
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Déterminer la répartition du poids 
en fonction des composants 


La première des actions à faire est de déterminer d'où provient la taille de votre 
package. Unity donne cette information par catégorie de composants dans le 
fichier de logs de l'éditeur (editor.log). Ce fichier est accessible après la généra- 


tion d'une build en utilisant le menu contextuel de la vue Console. 


(T Build terminée : StandaloneWindows - Ci /Users/onsthan/Desktop/Nouv u do 
#4" UnityEngine.Debug:Log{Object) Stack Trace Logging 


Maximize 
Close Tab 


Add Tab 


Voici un exemple de fichier produit par Unity lors de la génération d'une build 
PC. Vous remarquerez aussi qu'Unity indique les fichiers prenant le plus de 


place. 


#9 Ed - Bloc-notes = 0 x | 
Fichier Edition Format Affichage ? 
Lol 
Textures 1.8 mb 25.6% 
Meshes 6.8 kb e.0x 
Animations 2.8 kb 0.80% 
Sounds 162.4 kb 2.2% 
Shaders 712.3 kb  9.7% 
Other Assets 2.6 kb 8.8% 
Levels 23.2 kb 8.3% 
Scripts 504.5 kb 6.9% 
Included Dis 3.9 mb 55.0% 
File headers 14.4 kb 6.2% 
Complete size 7.2 mb 100.0% 


Used Assets and files from the Resources folder, sorted by uncompressed size: 
1.8 mb 25.6% Assets/Resources/CustomAsset .png 


713.2 kb 9.7% Resources/unity builtin_ extra 

48.7 kb 0.7% Assets/Standard Assets/Characters/FirstPersonCharacter/Audio/Footstepo2.wav 

47.1 kb @.6% Assets/Standard Assets/Characters/FirstPersonCharacter/Audio/Footstep@1. wav 

44.6 kb 6.6% Assets/Standard Assets/Characters/FirstPersonCharacter/Audio/Land.wav 

22.8 kb @.3% Assets/Standard Assets/Characters/FirstPersonCharacter/Audio/Jump.wav 

4.06 kb 9.1% D:/Unity5.1/Unity/Editor/Data/UnityExtensions/Unity/GUISystem/UnityEngine .UI .d11 

1.6 kb 6.68% D:/UnityS.1/Unity/Editor/Data/UnityExtensions/Unity/Networking/UnityEngine. Networking. d1l L 
1.1 kb 6.0% Assets/11/Player.prefab 

6.2 kb 6.68% Assets/Standard Assets/Characters/FirstPersonCharacter/Scripts/RigidbodyFirstPersonController cs 
6.2 kb 0.0% Assets/Standard Assets/CrossPlatforminput/Scripts/CrossPlatformInputManager.cs 

8.2 kb 6.06% Assets/Standard Assets/Characters/ThirdPersonCharacter/Scripts/ThirdPersonUserControl.cs 

8.2 kb 6.86% Assets/Standard Assets/Characters/FirstPersonCharacter/Scripts/FirstPersonController.cs 

6.2 kb 6.68% Assets/Standard Assets/CrossPlatforminput/Scripts/PlatformSpecific/Standaloneïnput.cs 

6.1 kb 6.0% D:/Unity5.1/Unity/Editor/Data/UnityExtensions/Unity/Advertisements/UnityEngine.Advertisements.d11 
8.1 kb 6.60% Assets/Standard Assets/Characters/ThirdPersonCharacter/Scripts/ThirdPersonCharacter cs 

6.1 kb 0.06% Assets/Standard Assets/Characters/ThirdPersonCharacter/Scripts/AlCharacterControl.cs 

8.1 kb 6.08% Assets/Standard Assets/CrossPlatformInput/Scripts/PlatformSpecific/Mobilelnput.cs 

6.1 kb 6.0% Assets/Standard Assets/CrossPlatforminput/Scripts/InputAxisScrollbar.cs 

0.1 kb 6.08% Astets/Standard a A ét em, es 4 
< . ; > 
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Dans ce cas, 1,8 mb (25,6 % de la taille du package) proviennent du fichier 
CustomAsset.png et 713,2 kb (9,7 %) proviennent d’un fichier Unity-builtin- 
extra. Le reste est réparti entre différents fichiers média (.wav), des librairies 
tierces (.dil) ainsi que des fichiers de code (.cs). 


Le stripping 


Le principe 


Le stripping est une technique consistant à enlever des binaires finaux les par- 
ties non utilisées du code et il peut être appliqué à trois niveaux différents. 
Cela est configurable dans l'Inspector à l'aide de la liste déroulante Stripping 
Level de la zone Other Settings - Optimization dans la configuration du 


player. 
Voici les trois niveaux disponibles avec la chaîne de compilation classique : 


- Niveau 0 - Disabled : dans cette situation, aucun stripping (et donc au- 
cune optimisation) n'est fait. 


— Niveau 1 - Strip Assemblies : le code IL des scripts et de leur référence est 
analysé et tout ce qui n'est pas utilisé est supprimé. Cela est sans risque 
lorsque vous n'utilisez pas de réflexion dans votre code. 


- Niveau 2 - Strip ByteCode : en plus des optimisations du niveau précé- 
dent, Unity va réduire les DLL .NET référencées par vos scripts à leur simple 
définition (leurs métadonnées). Cela ne pose pas de problème si vous utili- 
sez le compilateur AOT (IL2CPP) car le code sera déjà "présent" dans le bi- 
naire principal. 

- Niveau 3 - Use micro mscorlib : à ce niveau, Unity utilisera une version 
réduite du noyau .NET. Toute la partie réflexion, les GUID, l'utilisation des 
composants XML, etc. ne seront pas présentes par exemple. Il s'agit d'une 
option assez extrême à bien tester avant une mise en production. 


Remarque 


Un niveau de stripping implique à chaque fois que le niveau précédent est lui 
aussi appliqué. Par exemple, si le niveau 3 est activé alors le niveau 2 et 1 le 
sont aussi. 
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Attention à la réflexion 


Le stripping est réalisé en utilisant une analyse statique du code qui n'est pas 
capable de détecter une éventuelle utilisation de la réflexion au sein de votre 
code. Si un tel usage du framework .NET est fait dans votre code alors il faut 
indiquer à Unity les parties à conserver. Cela est réalisé en ajoutant un ou plu- 
sieurs fichiers link.xml dans n'importe quel dossier du projet Unity. 


Pour chaque élément à conserver, il faut : 


— spécifier le nom de l'assembly dans un élément XML assembly, 


— dans l'élément assembly, spécifier les types dans des sous-éléments type 
ou les espaces de nom dans des éléments namespace. Un attribut 
preserve indique ce qu'il faut garder : tout (a11), les champs (field), ou 
uniquement les déclarations (nothing). 


Voici un exemple de fichier link.xml permettant de conserver l'intégralité des 
classes de l'espace de noms System.Security.Cryptography: 


<linker> 
<assembly fullname="mscorlib"> 
<namespace fullname="System.Security.Cryptography.*" preserve="all"/> 
</assembly> 
</linker> 


Remarque 


Pour rappel, la réflexion consiste entre autres à instancier de façon dynar- 
mique des objets en se basant uniquement sur le nom des classes (et leur 
namespace) au moment de l'exécution du code. 


Stripping avec IL2CPP 


Du fait du mécanisme même d'IL2CPP, le stripping est configuré automati- 
quement au niveau 2 lorsque celui-ci est activé. Il est alors uniquement pos- 
sible d'activer ou de désactiver le stripping à l'aide d'une case à cocher dédiée. 
Le système de désactivation du stripping précédemment décrit reste cepen- 
dant fonctionnel et utilisable. 
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BRemarque 
Attention, un oubli des premières versions d'Unity 5 fait que l'ancienne liste 
déroulante apparaît au lieu de cette case à cocher. Dans ce cas, mettez à 
jour Unity 5 pour avoir la case à cocher. 


Niveau de compatibilité .NET 


Une technique complémentaire permettant de limiter la taille du package 
consiste à jouer sur le niveau de compatibilité du framework .NET utilisé. 


Il existe deux niveaux de compatibilité : .NET 2.0 et .NET 2.0 subset. Dans 
ce dernier, moins de classes sont disponibles et cela résulte en une taille de 
package plus petite mais une compatibilité moins grande avec d'éventuels 
autres plugins. 


Remarque 


À noter que l'utilisation de .NET 2.0 subset permet aussi d'avoir des temps de 
démarrage de l'application réduits. 


Optimisation des textures 


Dans la plupart des scénarios, le poids du package provient des textures (les 
images notamment) utilisées dans l'application. La première des choses à faire 
est bien sûr de s'assurer que la compression est activée sur celles-ci. 


SI cela n'est pas suffisant, il est possible de réduire la taille maximum des 
textures. Pour rappel, cette configuration est disponible dans Lie en 
sélectionnant une texture dans le champ Max Size. 
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inner 


Max Size 
Format 


' y POT texture can be FR if 
À ° R'maps are enabled 


CustomAsset 
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3 NET, 429 
2D, 57 


A Accéléromètre, 162 


AddComponent, 137 
Albedo, 207 
Ancrage, 297 
Android, 145, 404 
Animateur, 235 
Animation, 285 
Application, 144 
Assets, 45, 181 
Attributs, 71 
Audio, 99, 181, 226 
Audio Mixer, 229 
Autorité, 367 
Avatar, 202 
Awake, 122 

Axe virtuel, 160 


D Barres de défilement, 336 


Batching, 232 

Binding, 139 

Builds, 387 
formats, 388 
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génération, 401 

personnaliser, 414 
Bump Map, 208 
Button, 310 


Cache, 39 
Camera, 100 
Caméra, 181 
Canvas, 287 
Cg/HLSL, 213 
Champ de vision, 185 
Champs, 90 
Checkmark, 323 
Clavier, 168, 165 
Client, 362 
Collider, 265 
Collision, 271 
Compilation, 30 
Component, 50 


Composant, 50, 95 
ajouter, 104, 137 
composants de base, 67 
copier, 109 
réinitialiser, 110 
supprimer, 109, 137 
Configuration, 136 
Console, 63, 119 


Content Size Fitter, 350 
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Coroutine, 146 
déclarer, 148 
lancer, 149 
stopper, 150 


Couche 
Voir Layer 


Couleurs, 36 


D Débogage, 119 


delta Time, 124 

Design patterns, 150 

Destroy, 138 

Development Build, 403 
Dimensionnement, 343 
Directives de précompilation, 145 
Dillmport, 420 

Draw Calls, 232 


= Éditeur 


barre d'outils, 56 
interface, 29 
menus, 29 
personnaliser, /4 


Effets, 98 
Emission, 210 
Émulateur, 43 


Événement, 102, 373 
complexe, 142 
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déclarer, 140 
Events, 140 
Extensions, 39 


É Favoris, 62 


FixedUpdate, 126 
Focus, 134 
Forces, 263 

FOV, 185 

frame rate, 28 
Frustum, 184 


G GameObject, 48, 95, 102 


GetComponent, 137 
Gizmos, 58, 82, 129 
GEG 

Voir Grid Layout Group 


Global Illumination, 388, 193 
GPS, 162 

Gravité, 260 

Grid Layout Group, 347 
Gyroscope, 162 
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= Height Map, 209 


Hiérarchie du projet, 62 
HLAPI, 361 

Horizontal Layout Group, 343 
HTTP, 385 

Humanoid, 254 


Icon, 390 


IL2CPP, 424 
Image, 308 
IME, 163 
Input, 159, 161 
InputField, 318 
Inspector, 64 


Interface graphique, 285 

Interface utilisateur, 101, 128, 285 
Invoke, 140 

InvokeRepeating, 156 

iOS, 145, 409, 421 

Isométrique, 55 


J Joints, 278 


Joysticks, 164 


436 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


K Keyframes, 236 


L 


Langues, 352 
LateUpdate, 125 
Layer, 66 
Layout, 50, 341 
Legacy GUI, 286 
Licences, 25 
Light, 100 
Localisation, 352 
LOD, 100 


Lumière, 193 
Area, 199 
Directional, 198 
paramétrage, 194 
Point, 196 
Spot, 197 


Maille 
Voir Mesh 


Mask, 332 
Material, 200 


Matériaux, 199 
création, 202 
méthodes, 201 
physiques, 268 
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Mecanim, 235 

Menus personnalisés, 74 
Mesh, 97 

Mesh Renderer, 215 
Metallic, 206 
Microphone, 174 
Modules, 39 

Mono, 25, 423 
MonoBehaviour, 136 
MonoDevelop, 26 
Moteur physique, 259 
Multijoueurs, 361 


Native SDK (NDK), 419 
Navigation, 99, 313 
Normal Map, 208 


Object Pool, 153 
Objective-C, 419 
Occlusion Map, 209 
Ombre, 194 
OnApplicationFocus, 134 
OnApplicationQuit, 132 
OnBecamelnvisible, 127 
OnBecameVisible, 127 
OnDestroy, 131 
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OnDisable, 130 
OnDrawGizmos, 129 
OnEnable, 124 
OnGUI, 128 
OnValidate, 135 
Orthographic, 182 


Paramètres, 41 

Particules, 153 

PBS (Physically Based Shading), 206 
PC ou Mac, 145 

Performances, 153 

Perspective, 55, 182 

Physique 2D, 99 

Physique 3D, 98 

Pivot, 296 

Plateformes, 24 


Player, 387 
configuration, 388 


Plugin, 419 
Polices, 358 


Prefab 
création, 111 
modification, 115 


Préfabriqués 
Voir Prefab 


Programmation par composition, 95 
Projection, 182 
Projets, 30 
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Publishing, 390 


R Raccourcis, 37 


Rawlmage, 306 
Raycasting, 167 
Rect Transform, 295 


Rendu, 27, 61, 100 
événements, 127 


Réseau, 101 

Reset, 134 
Résolution, 61 
RigidBody, 126, 260 
RPC, 362 


S Scene, 92, 81 


Scènes, 30 

Screen Space, 289 

Script, 101, 117, 161 
ajouter, 118 
configuration, 186 
initialisation, 122 

Scrollbar, 330 

ScrollRect, 332, 338 

Selectable, 317 


Shader, 199, 205 
Built-in Shaders, 199 
Standard Shader, 199, 206 
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Surface Shader, 212 
Vertex/Fragment Shaders, 213 


Silverlight, 419 
Singleton, 150 
Skybox, 100, 182 
Slider, 327 

souris, 163, 166 
Specular, 206 
Splash, 390 

Sprite, 222 
Standalone, 413 
Start, 123 
Statistiques, 61 
Stripping, 400, 427 
Synchronisation, 379 
Système d’UI, 286 


T Tactile, 163, 168 


Text, 304 
Textures, 219 
Toggle, 323 
ToggleGroup, 323 
Traductions, 352 
Transition, 312 
Transparence, 207 
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Ui Scale Mode, 292 
UNET, 361 

Unity, 23 

Unity Cloud Build Pro, 31 
Unity UI, 285 
UnityEvent, 140 
UnityScript, 117 

Update, 124 


Vertical Layout Group, 347 


VGL 
Voir Vertical Layout Group 


Visual Studio, 27 


Webcam, 174, 177 

WebCam lexture, 177 
WebGL, 145, 414 

Window, 50 

Windows Phone, 145, 411, 422 
Windows Store, 410 

WWW, 385 

WWWEForm, 385 


442 


Unity3D 


Développer en C# des applications 2D/3D multiplateformes 


2 Zone d’ancrage, 300, 301, 302 
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Développer en C# des applications 2/3D multiplateformes 
(i0S, Android, Windows.) 


Ce livre présente les bases de la création d'une application multiplateformes avec Unity3D et le 
langage C#, dans le cadre de jeux vidéos comme d'applications d'entreprises. Il s'adresse à des 
développeurs C# qui débutent dans ce type de développement. Même si la création d'une applica- 
tion 2/3D, multiplateformes, paraît bien complexe à un débutant, les auteurs se sont appuyés sur 
des exemples simples et précis pour guider le lecteur dans sés premiers pas. Après la lecture de ce 
livre, il sera en mesure de créer son propre jeu et de le déployer sur les différentes plateformes 
ciblées par Unity3D : iPhone, iPad, Android, Windows, Windows Phone, Xbox, Blackberry. 


Après une présentation générale d'Unity3D et particulièrement de son éditeur, les auteurs dé- 
taillent les différents éléments, ou GameObjects, manipulés dans Unity3D et leurs composants. Un 
chapitre est bien sûr consacré au scripting (création, déboggage, cycle de vie...) et aux coroutines, 
un autre aux interactions avec l'utilisateur (entrées clavier, souris, tactile...) puis à l’utilisation 
des différents assets, au système d'animation et au moteur physique d’Unity3D. La description 
complète de la création d'une interface utilisateur (système Canvas, système de positionnement 
et d'ancrage, éléments d'affichage.) aboutit naturellement au chapitre sur le réseau et le système 
multijoueurs. Les derniers chapitres sont consacrés à la génération des PIC ER Ee par 
plateforme et à leur déploiement. 


Des éléments complémentaires sont en téléchargement puce site Www.e 
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